Using Agents with CLI

Start your coding agent and ask it to use your installed MONOid CLI.

Give the agent a valid MONOid API token and tell it to run CLI commands with JSON output when possible.

Agent prompt pattern

export MONOID_API_TOKEN="mo_..."
monoid whoami

Use MONOID_API_TOKEN for agent and CI usage. When stdout is not a TTY, the CLI defaults to JSON output.

Useful commands for agent workflows

# Workspace and task context
monoid inbox this_week -o json
monoid week -o json
monoid day -o json
monoid task-nav -o json

# Inspect available integrations for assignment
monoid integrations list --organisation-id <org_id> -o json

Assigning an agent from CLI

Use task update with a JSON body:

monoid tasks update <task_id> \
  --body '{"agentIntegrationId":"<integration_id>","agentDispatchMode":"immediate"}' \
  -o json

For routine-triggered dispatch mode, set "agentDispatchMode":"routine_trigger".

Related pages

• Overview — Agent model and providers
• Task Assigning — UI assigning flow
• CLI Overview — General CLI conventions