CLI command reference

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

The Multiflow 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 multiflow <command> --help.

Getting authenticated

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

multiflow 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 multiflow login --token <mul_...> to supply it directly.

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

Auth and setup

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

Workspaces and members

Command	Purpose
`multiflow workspace list`	List every workspace you can access
`multiflow workspace create --name "..." --slug "..." [--issue-prefix "..."] [--description "..."] [--context "..."]`	Create a workspace (you become its owner). `--name` and `--slug` are required; the slug is permanent. Does not switch your current workspace.
`multiflow workspace get <slug>`	Show details for one workspace
`multiflow workspace member list`	List members of the current workspace
`multiflow 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 (multiflow 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 multiflow issue list → copy the key → multiflow issue get MUL-123. Pass --full-id to a list command when you need the canonical UUID.

Command	Purpose
`multiflow issue list`	List issues (prints copy-paste-ready issue keys)
`multiflow issue get <id>`	Show a single issue (accepts an issue key or a UUID)
`multiflow issue create --title "..."`	Create a new issue
`multiflow issue update <id> ...`	Update an issue (status, priority, assignee, etc.)
`multiflow issue assign <id> --to <name>`	Assign to a member, agent, or squad (assigning to an agent triggers a run)
`multiflow issue status <id> <status>`	Shortcut to change status
`multiflow issue search <query>`	Keyword search
`multiflow issue children <id>`	List sub-issues grouped by stage
`multiflow issue pull-requests <id>`	List linked pull requests and their status
`multiflow issue runs <id>`	Show agent runs on an issue
`multiflow issue run-messages <task-id>`	Show messages for one execution
`multiflow issue usage <id>`	Show aggregated token usage for an issue
`multiflow issue rerun <id>`	Re-enqueue a fresh task for the issue's current agent assignee
`multiflow issue cancel-task <task-id>`	Cancel a queued or running task
`multiflow issue comment <id> ...`	Nested: view / post comments
`multiflow issue comment resolve/unresolve <comment-id>`	Mark a comment thread resolved or unresolved
`multiflow issue subscriber <id> ...`	Nested: subscribe / unsubscribe
`multiflow issue metadata <id> ...`	Nested: read / write issue metadata
`multiflow issue label <id> ...`	Nested: manage labels on an issue
`multiflow project list/get/create/update/delete/status`	Project CRUD
`multiflow label list/create/update/delete`	Workspace label CRUD

Agents and skills

Command	Purpose
`multiflow agent list`	List the workspace's agents
`multiflow agent get <slug>`	Show an agent's configuration
`multiflow agent create ...`	Create an agent
`multiflow agent update <slug> ...`	Update an agent
`multiflow agent archive <slug>`	Archive
`multiflow agent restore <slug>`	Restore an archived agent
`multiflow agent tasks <slug>`	Show an agent's task history
`multiflow agent avatar <slug>`	Upload an agent avatar
`multiflow agent env <slug> ...`	Read or replace an agent's custom environment variables
`multiflow agent skills ...`	Nested: attach / detach skills
`multiflow skill list/get/create/update/delete`	Skill CRUD
`multiflow skill import ...`	Import a skill from GitHub, ClawHub, or the local machine
`multiflow skill files ...`	Nested: manage a skill's files

Skill import conflicts

multiflow skill import --url <url> defaults to --on-conflict fail. If a skill with the same name already exists, the command exits with a structured conflict result and does not change the workspace.

Use --on-conflict overwrite when you created the existing skill and want to replace its content while preserving its ID and agent bindings. Use --on-conflict rename to import a copy with an automatic suffix such as -2. Use --on-conflict skip to leave the existing skill untouched and report skipped.

multiflow skill import --url https://skills.sh/acme/repo/review-helper
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict overwrite
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict rename
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict skip

Squads

Command	Purpose
`multiflow squad list`	List squads in the workspace
`multiflow squad get <id>`	Show a single squad
`multiflow squad create --name "..." --leader <agent>`	Create a squad (owner / admin)
`multiflow squad update <id> ...`	Update name, description, instructions, leader, or avatar
`multiflow squad delete <id>`	Archive (soft-delete) — transfers assigned issues to the leader
`multiflow squad member list/add/remove/set-role <squad-id>`	Manage squad members and update roles in place
`multiflow 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
`multiflow autopilot list`	List every autopilot in the workspace
`multiflow autopilot get <id>`	Show a single autopilot
`multiflow autopilot create ...`	Create an autopilot
`multiflow autopilot update <id> ...`	Update
`multiflow autopilot delete <id>`	Delete
`multiflow autopilot runs <id>`	Show run history
`multiflow autopilot trigger <id>`	Trigger a run manually
`multiflow autopilot trigger-add/update/delete <id>`	Manage schedule or webhook triggers
`multiflow autopilot trigger-rotate-url <id> <trigger-id>`	Rotate a webhook trigger URL

multiflow autopilot create/update also accepts --subscriber to set default subscribers for issues created by a create_issue autopilot; update accepts --clear-subscribers to remove them.

Daemon and runtimes

Command	Purpose
`multiflow daemon start`	Start the daemon (background by default; add `--foreground` to run in the foreground)
`multiflow daemon stop`	Stop the daemon
`multiflow daemon restart`	Restart the daemon
`multiflow daemon status`	Check whether the daemon is online and its concurrency
`multiflow daemon logs`	View daemon logs
`multiflow runtime list`	List runtimes in the current workspace
`multiflow runtime usage`	Show resource usage
`multiflow runtime activity`	Recent activity log
`multiflow runtime update <id> ...`	Initiate a CLI update on a runtime
`multiflow runtime delete <id> [--cascade]`	Delete a runtime, optionally archiving bound agents
`multiflow runtime profile ...`	Manage custom runtime profiles and local path overrides

Miscellaneous

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

Getting full flags

Every command supports --help:

multiflow issue create --help
multiflow 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 multiflow agent create

On this page