Open App

Using Agents with CLI

Use MONOid CLI as an agent interface for auth, task context, and assignment updates

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
monoid categories list --entity-type task -o json
monoid tasks list --category-id <category_id> -o json
monoid tasks list --organisation-id <org_id> --assignee-id <user_id> -o json
monoid tasks list --do-date-gte 2026-04-01 --do-date-lte 2026-04-30 -o json

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

Assigning and scheduling from CLI

Use first-class task flags:

# Assign agent + immediate run mode
monoid tasks update <task_id> \
  --agent-integration-id <integration_id> \
  --agent-dispatch-mode immediate \
  -o json

# Assign agent + routine-triggered mode
monoid tasks update <task_id> \
  --agent-integration-id <integration_id> \
  --agent-dispatch-mode routine_trigger \
  -o json

# Schedule by timestamp (ISO or epoch)
monoid tasks update <task_id> --scheduled-at 2026-05-20T09:00:00Z -o json

# Schedule by routine block
monoid tasks update <task_id> --routine-block-id <routine_block_id> -o json

Clear fields explicitly:

monoid tasks update <task_id> --clear-agent-integration -o json
monoid tasks update <task_id> --clear-agent-dispatch-mode -o json
monoid tasks update <task_id> --clear-scheduled-at -o json
monoid tasks update <task_id> --clear-routine-block -o json
MONOid
Product
Resources
Connect
© 2025 MONOid
All rights reserved.