Utility commands

auth, navigation, context, login, logout, setup-agent, and other operational helpers

whoami

monoid whoami

Verify auth and show current user and token scopes

Example

monoid whoami

Example output

{
  "data": {
    "userId": "user_abc123",
    "scopes": [
      "read",
      "write",
      "delete"
    ]
  }
}

monoid login

Store API token (prompt or pass token as argument)

Arguments

Name	Required	Description
`token`	No	—

Example

monoid login

Example output

Saved API token to ~/.config/monoid/credentials.json

logout

monoid logout

Remove stored API token

Example

monoid logout

Example output

Logged out.

setup-agent

monoid setup-agent

Print instructions for configuring MONOid CLI for AI agents

Example

monoid setup-agent

Example output

To use the MONOid CLI from an AI agent or script:

1. Set your API token:
   export MONOID_API_TOKEN="mo_..."

2. Optional: override API base URL:
   export MONOID_API_BASE_URL="https://api.usemonoid.com"

3. Verify auth:
   monoid whoami

status

monoid status

Situational summary: org count, containers, active projects, tasks by bucket, today's routines, upcoming reviews

Example

monoid status

Example output

{
  "data": {
    "organisations": 1,
    "containers": 4,
    "activeProjects": 12,
    "tasksByBucket": {
      "todo": 18,
      "in_progress": 6,
      "done": 42
    },
    "todayRoutineBlocks": 5,
    "reviews": 2
  }
}

calendar

monoid calendar

Items for period: week | day. Use --date YYYY-MM-DD to set anchor date (default: today)

Arguments

Name	Required	Description
`period`	Yes	—

Options

Flag	Description	Default
`--date <YYYY-MM-DD>`	Anchor date (default: today)	—
`--routines`	Include routine blocks	—
`--tasks`	Include tasks	—
`--reviews`	Include reviews	—

Example

monoid calendar

Example output

{
  "data": {
    "ok": true
  }
}

auth

monoid auth

Auth helpers

Example

monoid auth

Example output

{
  "data": {
    "ok": true
  }
}

auth check

monoid auth check

Validate token and show auth context

Example

monoid auth check

Example output

{
  "data": {
    "ok": true
  }
}

context

monoid context

Workspace context for humans and agents

Example

monoid context

Example output

{
  "data": {
    "ok": true
  }
}

inbox

monoid inbox

Task inbox: this_week | this_month

Arguments

Name	Required	Description
`tab`	No	—

Options

Flag	Description	Default
`--date <YYYY-MM-DD>`	Anchor date for this week calculations	—

Example

monoid inbox

Example output

{
  "data": {
    "ok": true
  }
}

week

monoid week

Week view with routine blocks and nested tasks

Arguments

Name	Required	Description
`date`	No	—

Example

monoid week

Example output

{
  "data": {
    "ok": true
  }
}

day

monoid day

Day view with routine blocks and nested tasks

Arguments

Name	Required	Description
`date`	No	—

Example

monoid day

Example output

{
  "data": {
    "ok": true
  }
}

nav

monoid nav

Navigate MONOid surfaces by path

Arguments

Name	Required	Description
`path`	No	—

Options

Flag	Description	Default
`--date <YYYY-MM-DD>`	Anchor date for /week or /day	—

Example

monoid nav

Example output

{
  "data": {
    "ok": true
  }
}

routine-creator

monoid routine-creator

Navigate and update routine templates and weekly routines

Example

monoid routine-creator

Example output

{
  "data": {
    "ok": true
  }
}

routine-creator show

monoid routine-creator show [date]

Show routine creator state

Arguments

Name	Required	Description
`date`	No	—

Example

monoid routine-creator show [date]

Example output

{
  "data": {
    "ok": true
  }
}

routine-creator templates

monoid routine-creator templates

Routine template CRUD

Example

monoid routine-creator templates

Example output

{
  "data": {
    "ok": true
  }
}

routine-creator templates list

monoid routine-creator templates list

—

Example

monoid routine-creator templates list

Example output

{
  "data": [
    {
      "_id": "abc123",
      "name": "Example item",
      "updatedAt": 1760000000000
    }
  ]
}

routine-creator templates get

monoid routine-creator templates get <id>

—

Arguments

Name	Required	Description
`id`	Yes	—

Example

monoid routine-creator templates get <id>

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

routine-creator templates create

monoid routine-creator templates create [options]

—

Options

Flag	Description	Default
`--name <name>`	Template name	—
`--category-id <id>`	Optional category id	—
`--default`	Mark as default	—

Example

monoid routine-creator templates create [options]

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

routine-creator templates update

monoid routine-creator templates update [options] <id>

—

Arguments

Name	Required	Description
`id`	Yes	—

Options

Flag	Description	Default
`--name <name>`	Template name	—
`--category-id <id>`	Category id	—
`--default <bool>`	true	false

Example

monoid routine-creator templates update [options] <id>

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

routine-creator templates delete

monoid routine-creator templates delete <id>

—

Arguments

Name	Required	Description
`id`	Yes	—

Example

monoid routine-creator templates delete <id>

Example output

{
  "data": null,
  "deleted": true
}

settings

monoid settings

Inspect and update settings

Example

monoid settings

Example output

{
  "data": {
    "ok": true
  }
}

settings show

monoid settings show [options]

—

Options

Flag	Description	Default
`--organisation-id <id>`	Optional organisation scope	—

Example

monoid settings show [options]

Example output

{
  "data": {
    "ok": true
  }
}

settings update

monoid settings update [options]

—

Options

Flag	Description	Default
`--first-day-of-week <n>`	0=Sunday..6=Saturday	—
`--wake-time <HH:MM>`	Wake time	—
`--wake-end-time <HH:MM>`	Wake end time	—
`--sleep-time <HH:MM>`	Sleep time	—
`--sleep-end-time <HH:MM>`	Sleep end time	—

Example

monoid settings update [options]

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

integrations

monoid integrations

Inspect and update integrations

Example

monoid integrations

Example output

{
  "data": {
    "ok": true
  }
}

integrations list

monoid integrations list [options]

—

Options

Flag	Description	Default
`--organisation-id <id>`	Optional organisation scope	—

Example

monoid integrations list [options]

Example output

{
  "data": [
    {
      "_id": "abc123",
      "name": "Example item",
      "updatedAt": 1760000000000
    }
  ]
}

integrations update-linear-mappings

monoid integrations update-linear-mappings [options]

—

Options

Flag	Description	Default
`--body <json>`	JSON object of Linear user mappings	—
`--organisation-id <id>`	Optional organisation scope	—

Example

monoid integrations update-linear-mappings [options]

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

integrations delete

monoid integrations delete [options] <provider>

—

Arguments

Name	Required	Description
`provider`	Yes	—

Options

Flag	Description	Default
`--organisation-id <id>`	Optional organisation scope	—

Example

monoid integrations delete [options] <provider>

Example output

{
  "data": null,
  "deleted": true
}

templates

monoid templates

Inspect templates

Example

monoid templates

Example output

{
  "data": {
    "ok": true
  }
}

templates list

monoid templates list [options]

—

Options

Flag	Description	Default
`--entity-type <type>`	project	task
`--review-type <type>`	daily	weekly

Example

monoid templates list [options]

Example output

{
  "data": [
    {
      "_id": "abc123",
      "name": "Example item",
      "updatedAt": 1760000000000
    }
  ]
}

templates get

monoid templates get <id>

—

Arguments

Name	Required	Description
`id`	Yes	—

Example

monoid templates get <id>

Example output

{
  "data": {
    "_id": "abc123",
    "updatedAt": 1760000000000
  }
}

admin

monoid admin

Admin and internal surfaces

Example

monoid admin

Example output

{
  "data": {
    "ok": true
  }
}

admin users

monoid admin users

Admin user operations

Example

monoid admin users

Example output

{
  "data": {
    "ok": true
  }
}

admin users list

monoid admin users list [options]

—

Options

Flag	Description	Default
`--email <email>`	Filter by email	—
`--id <id>`	Filter by clerk user id	—

Example

monoid admin users list [options]

Example output

{
  "data": [
    {
      "_id": "abc123",
      "name": "Example item",
      "updatedAt": 1760000000000
    }
  ]
}

admin users delete

monoid admin users delete <id>

—

Arguments

Name	Required	Description
`id`	Yes	—

Example

monoid admin users delete <id>

Example output

{
  "data": null,
  "deleted": true
}

admin routine-blocks

monoid admin routine-blocks

List all routine blocks

Example

monoid admin routine-blocks

Example output

{
  "data": {
    "ok": true
  }
}

App Integrations

Utility commands