Developer Edition Only — This content applies to the Developer Edition license.
Claudius Corp ships a command-line interface that AI agents and developers can use to interact with the workflow engine from a terminal. The CLI is invoked via the dmsi command.
Usage #
dmsi <command> [subcommand] [options]
Environment Variables #
The CLI reads the following environment variables for context:
| Variable | Description |
|---|---|
DMSI_PROJECT_ID | Current project ID |
DMSI_PHASE_ID | Current phase ID |
DMSI_AGENT_ID | Current agent ID |
DMSI_ROLE | Current agent role shortname |
DMSI_REWORK_ID | Current rework request ID |
DMSI_DB_PATH | Override database path |
DMSI_PROJECT_PATH | Project folder path |
DMSI_DEBUG | Enable debug output |
Command Reference #
dmsi task — Task Management #
dmsi task list # List tasks for current phase
dmsi task get <id> # Get task details
dmsi task create "<title>" [--desc "<d>"] [--criteria "<c>"] [--sequence <n>] [--depends-on <id>]
dmsi task start <id> # Mark task as in-progress
dmsi task complete <id> # Mark task as completed
dmsi task fail <id> [reason] # Mark task as failed
dmsi task retry <id> [--instructions "<msg>"] # Retry a failed task
dmsi task cancel <id> [--replaced-by <id>] [--reason "<r>"]
dmsi task stuck <id> # Mark task as stuck
dmsi task current # Show first pending/in-progress task
dmsi phase — Phase Management #
dmsi phase current # Show current phase info (name, type, role, status)
dmsi phase complete # Request phase completion (creates approval request)
dmsi phase status # Show progress: X% (completed/total)
dmsi phase list # List all phases in the project
dmsi rework — Rework Management #
dmsi rework create --category <REQ|ARCH|DEV|UI> --issues "<description>"
dmsi rework complete --manifest <filepath>
dmsi rework status # Show current rework status
dmsi rework list # List all rework requests
dmsi agent — Agent Control (EC role only) #
dmsi agents list [--status <status>] # List agents (default: running)
dmsi agent pause <agent_id> # Pause a running agent
dmsi agent resume <agent_id> # Resume a paused agent
dmsi agent terminate <agent_id> # Terminate an agent
dmsi agent message <agent_id> "<message>" # Send message to agent
dmsi agent redirect <agent_id> --task <task_id> # Redirect agent to a task
dmsi agent info <agent_id> # Show agent details
dmsi approval — Approval Workflow (EC role only) #
dmsi approvals list # List pending approvals
dmsi approval decide <id> --option <opt> [--note "<note>"] # Decide on an approval
dmsi approval escalate <id> [--note "<note>"] # Escalate an approval
dmsi approval info <id> # Show approval details
dmsi escalate — Escalation #
dmsi escalate create --to <ec|ceo> --message "<msg>" # Create an escalation
dmsi escalate check --id <escalation-id> # Check escalation status
dmsi notify — Notifications #
dmsi notify create "<title>" "<message>" [--type <info|warning|error>]
dmsi notify list [--type <type>] [--unread]
dmsi context — Context Display #
dmsi context # Show full context including project, phase, rework info
dmsi status — Status #
dmsi status # Show current context status summary
dmsi project — Project Operations #
dmsi project info # Show current project information
dmsi project list [--status <status>] # List projects with optional filter
dmsi log — Logging #
dmsi log "<message>" # Write a message to the agent activity log
dmsi memory — Memory Queries #
dmsi memory <subcommand> # Product memory operations
dmsi learnings — Learnings #
dmsi learnings list [--role <shortName>] [--tags <tag1,tag2>]
dmsi help and dmsi version #
dmsi help # Show full command reference
dmsi version # Show CLI version
Agent ID Matching #
Agent IDs are UUIDs. The dmsi agent commands support prefix matching — you can use just the first 8 characters of the UUID:
dmsi agent info abc12345 # Matches agent ID starting with "abc12345"