Built For You and Your Agents

Run MONOid from your terminal with the CLI with agent-ready workflows.

user@workstation — monoid
Last login: Fri Mar 27 13:23:41 on ttys011
(base) user@workstation ~ % monoid

MONOid CLI

  nav /week                        browse the current week
  day                              current day view
  tasks                            rich task navigator
  whoami                           verify token and current user
  auth check                       verify token and organisation access
  integrations list                list available integrations

monoid> whoami
you@company.com | orgs: 2
monoid> day -o json
{"date":"2026-03-27","routineBlocks":7,"tasks":8}
monoid> tasks /a me -o json
[{"id":"task_01J8W3M9N2A4","title":"Rewrite agents page for CLI-first onboarding"}]

monoid>

Agent-ready JSON output

Run commands with JSON output so OpenClaw, CLI agents, and scripts can parse context and act deterministically.

Shared planning model

Agents and humans operate on the same week/day/task context, so delegation stays aligned with active priorities.

Direct task updates

Write notes, status changes, and assignment fields back into tasks from terminal commands.

Integration-aware execution

List integrations and set task dispatch mode using CLI payloads without switching surfaces.

How It Works

1

Check your daily routine

Pull day context, task queues, and routine blocks so your agent works against the right scope for today.

Daily Routine
$ monoid day
2026-03-30 | routines: 7 | tasks: 8

$ monoid tasks /a me
Tasks | total: 1
Filter: assignee = me
Buckets: todo:1
  - [todo] Rewrite agents page for CLI-first onboarding | project:Agent Workflows | assignee:me | scope:organisation:org_01J8T3A2X9

$ monoid routine-blocks list
date        startTime  endTime  name
----------  ---------  -------  ----------------
2026-03-30  08:00      11:30    Product Building

$ monoid day -o json
{"date":"2026-03-30","routineBlocks":7,"tasks":8}

$ monoid tasks /a me -o json
[{"id":"task_01J8W3M9N2A4","title":"Rewrite agents page for CLI-first onboarding","bucket":"todo"}]

$ monoid routine-blocks list -o json
[{"id":"rb_01","name":"Product Building","startTime":"08:00","endTime":"11:30"}]
2

Create tasks and link to projects

Describe what you need in plain language; your agent resolves project ids, runs monoid, and returns the CLI transcript plus structured output when you ask for JSON.

CLI agent session
You
On project “Agent Workflows”, create two tasks: “Ship CLI-first agents walkthrough”, and “Document OpenClaw + Claude CLI examples” assigned to user_01J8VY1L2M5. Then show the same flow with -o json for scripting.

Agent
Match the project name to an id, create both tasks (second with assignee), then replay with -o json.

 projects list: only one active row matches “Agent Workflows”.
 tasks create ×2: both land in todo on proj_01J8W4P7Q6R1.
 same commands with -o json for pipes / scripts.

$ monoid projects list --limit 5
proj_01J8W4P7Q6R1  active  Agent Workflows

$ monoid tasks create --title "Ship CLI-first agents walkthrough" --project-id proj_01J8W4P7Q6R1
task_01J8W58C3T9  todo

$ monoid tasks create --title "Document OpenClaw + Claude CLI examples" --project-id proj_01J8W4P7Q6R1 --assignee-id user_01J8VY1L2M5
task_01J8W5AT8K2  todo  assignee user_01J8VY1L2M5

-o json (same invocations):
[{"id":"proj_01J8W4P7Q6R1","name":"Agent Workflows"}]
{"id":"task_01J8W58C3T9","title":"Ship CLI-first agents walkthrough","projectId":"proj_01J8W4P7Q6R1","bucket":"todo"}
{"id":"task_01J8W5AT8K2","title":"Document OpenClaw + Claude CLI examples","projectId":"proj_01J8W4P7Q6R1","assigneeId":"user_01J8VY1L2M5","bucket":"todo"}

Done — both tasks are in todo on Agent Workflows; use the JSON lines for automation or pipes.
3

Allow agents to manage and review

Assign tasks to users or agents, mark work done, then submit a daily review to close the execution loop.

Management & Review
$ monoid tasks update task_01J8W58C3T9 --assignee-id user_01J8VY1L2M5
_id               assigneeId        bucket  title
---------------  ---------------   ------  -----------------------------------
task_01J8W58C3T9  user_01J8VY1L2M5  todo  Ship CLI-first agents walkthrough

$ monoid tasks update task_01J8W58C3T9 --body '{"agentIntegrationId":"agi_01J8VQ7B4X9","agentDispatchMode":"immediate"}'
_id               agentDispatchMode  runStatus  title
---------------  -----------------  ---------  -----------------------------------
task_01J8W58C3T9  immediate          queued     Ship CLI-first agents walkthrough

$ monoid tasks update task_01J8W58C3T9 --bucket done
_id               bucket  title
---------------  ------  -----------------------------------
task_01J8W58C3T9  done    Ship CLI-first agents walkthrough

$ monoid reviews create --date 2026-03-30 --type daily --description "Completed priorities and captured blockers."
_id        date        type   description
--------   ----------  -----  -------------------------------------------
review_77  2026-03-30  daily  Completed priorities and captured blockers.

$ monoid tasks update task_01J8W58C3T9 --assignee-id user_01J8VY1L2M5 -o json
{"id":"task_01J8W58C3T9","assigneeId":"user_01J8VY1L2M5"}

$ monoid tasks update task_01J8W58C3T9 --body '{"agentIntegrationId":"agi_01J8VQ7B4X9","agentDispatchMode":"immediate"}' -o json
{"id":"task_01J8W58C3T9","agentIntegrationId":"agi_01J8VQ7B4X9","agentDispatchMode":"immediate","runStatus":"queued"}

$ monoid tasks update task_01J8W58C3T9 --bucket done -o json
{"id":"task_01J8W58C3T9","bucket":"done"}

$ monoid reviews create --date 2026-03-30 --type daily --description "Completed priorities and captured blockers." -o json
{"id":"review_77","type":"daily","date":"2026-03-30","status":"created"}
Terminal
$ agent
Agent session started

You: Run monoid day -o json and monoid tasks /a me -o json, then propose next actions.
Agent: Found 8 tasks, prioritizing Product Building queue.

$ monoid tasks update task_01J8W58C3T9 --status in_progress --note "Plan approved, implementation started"
Task task_01J8W58C3T9 updated

$ monoid tasks update task_01J8W5AT8K2 --status blocked --note "Blocked on API access"
Task task_01J8W5AT8K2 updated

Use with any CLI Agent

Any CLI-capable agent can run MONOid commands, read context, and send structured updates back to tasks.

1. Start your preferred CLI agent in your repo shell.

2. Ask it to run MONOid commands for context and planning.

3. Apply returned task updates directly in CLI.

Expected result: a model-agnostic workflow that works with Codex, Claude Code, OpenCode, or any agent that can execute CLI commands.

Use with OpenClaw

Run OpenClaw against MONOid context, then sync status and notes back to tasks. OpenClaw gateway webhooks need to be connected for this to work.

1. Pull day and task context from MONOid.

2. Ask Openclaw for a scoped implementation plan.

3. Write results back into MONOid task status + notes.

Expected result: Openclaw execution loop stays fully traceable in MONOid tasks.

Terminal
$ monoid day -o json
{"date":"2026-03-30","tasks":8}

$ monoid tasks /a me -o json
[{"id":"task_01J8W58C3T9","title":"Ship CLI-first agents walkthrough"}]

$ openclaw run "Use MONOid task context and return plan + blockers by task id."
OpenClaw: task_01J8W58C3T9 -> plan drafted, blockers:none

$ monoid tasks update task_01J8W58C3T9 --status in_progress --note "OpenClaw plan attached"
Task task_01J8W58C3T9 updated

Openclaw Interaction Modes

Choose direct chat control or scheduled automation, using the same MONOid CLI workflow underneath.

WhatsApp / Telegram
You: Run my Product Building tasks for today and update status in MONOid.
OpenClaw: Done. task_01J8W58C3T9 -> in_progress, note added.

$ monoid tasks get task_01J8W58C3T9
... bucket: in_progress ... notes: OpenClaw plan attached ...

From any chat app

WhatsApp, Telegram, Slack, Discord...

Send OpenClaw a task goal from chat, and it can run MONOid CLI commands and push task updates automatically.

openclaw.json
$ cat openclaw.json
{"heartbeat":[{"cron":"0 9 * * 1-5","prompt":"Run monoid day, update priority tasks, then create daily review summary."}]}

$ openclaw daemon start
Heartbeat active: next run at 2026-03-31 09:00

Scheduled function

Cron-based recurring execution

Configure heartbeat jobs so OpenClaw runs MONOid task triage and review prep on schedule, without manual prompts.

Technical docs

MONOid is time where it matters,

Connect the rest