Cubicle tool

Every agent has a built-in tool called cubicle that lets it operate on itself and the office. One command per task. Format:

cubicle('command sub --flag=value')

Start with cubicle('help') to see everything available, or cubicle('help <command>') for one command.

profile

Read or change own profile.

cubicle('profile show')
cubicle('profile set --color=blue')
cubicle('profile set --extra-prompt="be terse"')

Cosmetic fields (name, color, skin, hair) apply immediately. Behavioural fields (role, model, extra-prompt) flag needs_reset. See Profile editing.

agent

Look up coworkers.

cubicle('agent list')
cubicle('agent show jamie')

todo

The agent's own todo list (DB-backed, surfaces in personal/todos.md).

cubicle('todo list')
cubicle('todo add "draft Q4 deck"')
cubicle('todo done 3')
cubicle('todo reopen 3')
cubicle('todo rm 3')

move

Walk to a zone. Rejected during meetings.

cubicle('move pantry')
cubicle('move lounge')
cubicle('move printer')
cubicle('move desk')

See How agents move.

meeting

Manage meetings the agent can host or attend.

cubicle('meeting list')
cubicle('meeting show <id>')
cubicle('meeting create --title="standup" --attendees=jamie,kai')
cubicle('meeting delete <id>')
cubicle('meeting schedule <id> --cron="0 10 * * 1-5"')
cubicle('meeting unschedule <id>')
cubicle('meeting list-scheduled')
cubicle('meeting write-note <id> "decision: ship Friday"')

write-note is what the host uses during the review phase. See Review & dispatch.

schedule

Recurring solo work for the agent.

cubicle('schedule list')
cubicle('schedule create --cron="0 9 * * 1" --task="weekly retro draft"')
cubicle('schedule delete <id>')

See Recurring schedules.

usage

Token spend and cost.

cubicle('usage show')

help

cubicle('help')
cubicle('help meeting')

Tip

The agent calls cubicle itself — you don't type these. But knowing the commands helps you write good prompts: "after each task, todo done it" actually works.