CLI command reference

One-page overview of every top-level Multica CLI command. For full usage, run `multica <command> --help`.

The Multica CLI mirrors almost everything the Web UI can do (create issues, assign agents, start the daemon, and more). This page lists every top-level command with a one-line description. For the full set of flags and examples, run multica <command> --help.

Getting authenticated

Run this the first time you use the CLI to obtain a personal access token (PAT):

multica login

Your browser opens automatically. After you approve in the web app, the CLI saves the PAT (prefixed with mul_) to ~/.multica/config.json. Every subsequent command authenticates with that PAT.

For CI or headless environments, skip the browser flow: create a PAT in the web app under Settings → Personal Access Tokens, then run multica login --token <mul_...> to supply it directly.

For the difference between token types, see Authentication and tokens.

Auth and setup

Command	Purpose
`multica login`	Log in and save a PAT
`multica auth status`	Show current login status, user, and workspace
`multica auth logout`	Clear the local PAT
`multica setup cloud`	One-shot setup for Multica Cloud (login + install daemon)
`multica setup self-host`	One-shot setup for a self-hosted backend

User profile

Command	Purpose
`multica user profile get`	Show your current user profile (name, email, profile description)
`multica user profile update --description "..."`	Update your profile description injected into agent briefs. Also accepts `--description-stdin`, `--description-file <path>`, or `--clear` to remove.

Workspaces and members

Command	Purpose
`multica workspace list`	List every workspace you can access
`multica workspace get <slug>`	Show details for one workspace
`multica workspace member list`	List members of the current workspace
`multica workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."]`	Update workspace metadata (admin/owner). Long fields accept `--description-stdin` / `--context-stdin`.

Issues and projects

list commands (multica issue list, autopilot list, project list, etc.) print short, copy-paste-ready IDs by default — issue keys like MUL-123 for issues, short UUID prefixes for the rest. The <id> argument on the follow-up commands below accepts either the short ID or the full UUID, so the typical flow is multica issue list → copy the key → multica issue get MUL-123. Pass --full-id to a list command when you need the canonical UUID.

Command	Purpose
`multica issue list`	List issues (prints copy-paste-ready issue keys)
`multica issue get <id>`	Show a single issue (accepts an issue key or a UUID)
`multica issue create --title "..."`	Create a new issue. Optional: `--run-at <RFC3339-with-offset>` to arm a one-shot scheduled agent run at creation time.
`multica issue update <id> ...`	Update an issue (status, priority, assignee, etc.). Optional: `--run-at <RFC3339-with-offset>` to set or update the scheduled run time; pass an empty string (`--run-at ""`) to clear it.
`multica issue assign <id> --to <name>`	Assign to a member, agent, or squad (fuzzy match). Use `--to-id <uuid>` for an exact UUID match, or `--unassign` to remove the current assignee.
`multica issue status <id> <status>`	Shortcut to change status. Valid values: `backlog`, `todo`, `in_progress`, `in_review`, `done`, `blocked`, `cancelled`.
`multica issue search <query>`	Keyword search
`multica issue runs <id>`	Show agent runs on an issue
`multica issue run-messages <task-id>`	List messages for an execution. Optional: `--issue <id>` to scope short task ID resolution, `--since <seq>` to return only messages after a sequence number.
`multica issue cancel-task <task-id>`	Cancel a running or queued task (interrupts in-flight agent). Optional: `--issue <id>` to scope short task ID resolution.
`multica issue rerun <id>`	Re-enqueue a fresh task for the issue's current agent assignee
`multica issue schedule <id> --at <RFC3339>`	Arm a one-shot scheduled run time on an issue (agent auto-runs once at that time). Use `--clear` to disarm. `--at` and `--clear` are mutually exclusive; one is required.
`multica issue label list <issue-id>`	List labels attached to an issue
`multica issue label add <issue-id> <label-id>`	Attach a label to an issue
`multica issue label remove <issue-id> <label-id>`	Remove a label from an issue
`multica issue metadata list <issue-id>`	List all metadata keys on an issue
`multica issue metadata get <issue-id> --key <key>`	Get a single metadata key value
`multica issue metadata set <issue-id> --key <key> --value <value>`	Set a metadata key. Value is auto-typed (bool, number, string); use `--type string/number/bool` to override.
`multica issue metadata delete <issue-id> --key <key>`	Delete a metadata key
`multica issue comment <id> ...`	Nested: view / post comments
`multica issue subscriber <id> ...`	Nested: subscribe / unsubscribe
`multica project list/get/create/update/delete/status`	Project CRUD

Labels

Command	Purpose
`multica label list`	List labels in the workspace
`multica label get <id>`	Show a single label
`multica label create --name "..." --color "#..."`	Create a label (name and hex color required)
`multica label update <id> [--name "..."] [--color "#..."]`	Update a label's name or color
`multica label delete <id>`	Delete a label

Agents and skills

Command	Purpose
`multica agent list`	List the workspace's agents
`multica agent get <slug>`	Show an agent's configuration
`multica agent create ...`	Create an agent
`multica agent update <slug> ...`	Update an agent
`multica agent archive <slug>`	Archive
`multica agent restore <slug>`	Restore an archived agent
`multica agent tasks <slug>`	Show an agent's task history
`multica agent skills ...`	Nested: attach / detach skills
`multica skill list/get/create/update/delete`	Skill CRUD
`multica skill import ...`	Import a skill from URL sources (`github.com`, `clawhub.ai`, `skills.sh`)
`multica skill files ...`	Nested: manage a skill's files

Squads

Command	Purpose
`multica squad list`	List squads in the workspace
`multica squad get <id>`	Show a single squad
`multica squad create --name "..." --leader <agent>`	Create a squad (owner / admin)
`multica squad update <id> ...`	Update name, description, instructions, leader, or avatar
`multica squad delete <id>`	Archive (soft-delete) — transfers assigned issues to the leader
`multica squad member list/add/remove/set-role <squad-id>`	Manage squad members and update roles in place
`multica squad activity <issue-id> <action\|no_action\|failed> --reason "..."`	Used by squad leader agents to record an evaluation per turn

See Squads for the full model.

Autopilots

Command	Purpose
`multica autopilot list`	List every autopilot in the workspace
`multica autopilot get <id>`	Show a single autopilot
`multica autopilot create ...`	Create an autopilot
`multica autopilot update <id> ...`	Update
`multica autopilot delete <id>`	Delete
`multica autopilot runs <id>`	Show run history
`multica autopilot trigger <id>`	Trigger a run manually

Daemon and runtimes

Command	Purpose
`multica daemon start`	Start the daemon (background by default; add `--foreground` to run in the foreground)
`multica daemon stop`	Stop the daemon
`multica daemon restart`	Restart the daemon
`multica daemon status`	Check whether the daemon is online and its concurrency
`multica daemon logs`	View daemon logs
`multica daemon disk-usage`	Show workspace disk usage by task or workspace. Optional: `--by-workspace` to aggregate by workspace, `--top <n>` to limit results, `--workspaces-root <path>` to override the default path.
`multica runtime list`	List runtimes in the current workspace
`multica runtime usage`	Show resource usage
`multica runtime activity`	Recent activity log
`multica runtime update <id> ...`	Update a runtime's configuration

Miscellaneous

Command	Purpose
`multica repo checkout <url>`	Clone a repo locally for agents to use
`multica config`	View or edit local CLI configuration
`multica version`	Print the CLI version
`multica update`	Upgrade the CLI to the latest release
`multica attachment download <id>`	Download an attachment from an issue or comment

Getting full flags

Every command supports --help:

multica issue create --help
multica agent update --help

v2 will ship a dedicated detailed reference page for each command.

Next steps

Authentication and tokens — PAT vs. JWT vs. daemon token
Daemon and runtimes — how the daemon commands work under the hood
Creating and configuring agents — all options for multica agent create

On this page