Skip to main content
Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see Get started.

​
Choose a company

After installing the CLI, sign in and list the companies you can access:
Use the UUID of your invited Agents company to select it, then make a read:
The CLI calls companies workspace. Selection follows this order: --workspace-id, then MELSO_WORKSPACE_ID, then the profile default saved by workspace switch. Clear a previous environment override or flag if you intend to use the profile default.

​
Create work

Confirm that the harness and execution funding are available to your account before starting a Run:
The returned Task id is the identifier to keep. To save an idle Task instead, use melso task create --title "Review the draft" without a prompt.
A Task can have several Runs. Follow successor attempts after retries or pauses; the first attempt’s failure does not always mean the Task has stopped. Runs explains the states and newest-first ordering.

​
Read the result

Once an outcome Run completes, read the stored Task messages:
Read the assistant reply whose run_id matches the completed Run. The JSON output is a message array; if there are older pages, the CLI prints the next --before-created-at and --before-id values to standard error. Supply both to continue. Stored replies have output redaction applied; review the content before treating the work as delivered. For the execution transcript, copy the Run’s actual id from task runs:

​
Send a follow-up

With the human login used above, this command posts a message and requests another turn of work:
Follow the new Run and read its stored reply using the commands above. A message receipt alone does not establish completion. A completed Task can reopen on a human follow-up; an explicitly cancelled Task remains read-only. For longer or private document text, save a UTF-8 file in your current directory and use melso task message create "$TASK_ID" --content-file ./follow-up.txt. Standard input is also supported with --content-stdin. Keep credentials out of Task text and private documents out of terminal history.

​
Resume paused work

Resume takes the Task ID, even though it is under run:
Use it only for a paused Task. After resuming, observe its Runs again because the successor can have a different ID. Use melso task --help and melso run --help for other controls.