Quick Start

You are authenticated. Start here to get moving quickly.

Open the CLI entry screen

Run monoid with no subcommand to open the CLI start screen:

monoid

This shows the main command groups and common examples.

First commands to run

monoid whoami
monoid status
monoid day
monoid organisations list

• whoami confirms your token and scopes.
• status gives a high-level summary.
• day gives today-focused context.
• organisations list confirms basic API access.

Quick agent usage

The MONOid CLI is built to be agent-friendly for AI coding agents and autonomous assistants. If you use tools like Codex or OpenClaw, start your coding agent and ask it to use your installed MONOid CLI for authentication checks and command execution.

Use JSON output for agent work:

monoid whoami -o json
monoid tasks list --do-date-eq 2026-06-30 -o json

For any write, ask the agent to show a before/after check:

# Before
monoid tasks get <task_id> --include-notes false -o json

# Write
monoid tasks update <task_id> --bucket in_progress -o json

# Verify
monoid tasks get <task_id> --include-notes false -o json

Use the narrowest API key scope that can complete the job. Prefer read-only keys for inspection and add write/delete scopes only when the agent needs to change data.

To set up your agent:

• Codex · Docs
• Claude Code · Docs
• OpenCode · Docs
• Cursor CLI · Docs
• OpenClaw · Docs

Next

• Output formats — Understand json, table, and csv.
• Organisations — Start with resource commands.
• Utility commands — Navigation, context, auth helpers, and more.
• Using Agents with CLI — Handoff and verification patterns.