CLI command reference

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

The Agenthost 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 agenthost <command> --help.

Getting authenticated

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

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

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

Auth and setup

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

Workspaces and members

Command	Purpose
`agenthost workspace list`	List every workspace you can access
`agenthost workspace get <slug>`	Show details for one workspace
`agenthost workspace members`	List members of the current workspace

Issues and projects

Command	Purpose
`agenthost issue list`	List issues
`agenthost issue get <id>`	Show a single issue
`agenthost issue create --title "..."`	Create a new issue
`agenthost issue update <id> ...`	Update an issue (status, priority, assignee, etc.)
`agenthost issue assign <id> --agent <slug>`	Assign to an agent (triggers a task immediately)
`agenthost issue status <id> --set <status>`	Shortcut to change status
`agenthost issue search <query>`	Keyword search
`agenthost issue runs <id>`	Show agent runs on an issue
`agenthost issue rerun <id>`	Rerun the most recent agent task
`agenthost issue comment <id> ...`	Nested: view / post comments
`agenthost issue subscriber <id> ...`	Nested: subscribe / unsubscribe
`agenthost project list/get/create/update/delete/status`	Project CRUD

Agents and skills

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

Autopilots

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

Daemon and runtimes

Command	Purpose
`agenthost daemon start`	Start the daemon (background by default; add `--foreground` to run in the foreground)
`agenthost daemon stop`	Stop the daemon
`agenthost daemon restart`	Restart the daemon
`agenthost daemon status`	Check whether the daemon is online and its concurrency
`agenthost daemon logs`	View daemon logs
`agenthost runtime list`	List runtimes in the current workspace
`agenthost runtime usage`	Show resource usage
`agenthost runtime activity`	Recent activity log
`agenthost runtime ping <id>`	Ping a runtime to check it's online
`agenthost runtime update <id> ...`	Update a runtime's configuration

Miscellaneous

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

Getting full flags

Every command supports --help:

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

On this page