# CLI reference Use `cotal help ` for the flags supported by your installed version. For a first local mesh, start with the [Quickstart](/docs/getting-started/). ## Choose a reference **Workstation** - [CLI usage](/api-reference/cli-usage/) - [CLI installation](/api-reference/cli-installation/) - [CLI spaces](/api-reference/cli-selection/) **Mesh lifecycle** - [CLI startup](/api-reference/cli-startup/) - [CLI shutdown](/api-reference/cli-shutdown/) - [CLI backups](/api-reference/cli-backups/) **Agents** - [Agent launch reference](/api-reference/cli-agents/) - [Agent terminal control](/api-reference/cli-agent-control/) - [Agent view reference](/api-reference/cli-agent-views/) **Services** - [Local service reference](/api-reference/cli-services/) - [Process supervision](/api-reference/cli-processes/) - [Manager maintenance](/api-reference/cli-maintenance/) - [Linear integration](/api-reference/cli-integrations/) **Communication** - [CLI endpoints](/api-reference/cli-endpoints/) - [CLI messaging](/api-reference/cli-messaging/) - [CLI observation](/api-reference/cli-observation/) **Authority and workflows** - [CLI authentication](/api-reference/cli-auth/) - [CLI workflow runs](/api-reference/cli-runs/) ## Find a command Each entry links to its full syntax and behavior. ### Running it [CLI usage](/api-reference/cli-usage/#running-it) ### Structured output [CLI usage](/api-reference/cli-usage/#structured-output) ### Commands [CLI usage](/api-reference/cli-usage/#commands) ### setup [CLI installation](/api-reference/cli-installation/#setup) ### update [CLI installation](/api-reference/cli-installation/#update) ### up [CLI startup](/api-reference/cli-startup/#up) ### down [CLI shutdown](/api-reference/cli-shutdown/#down) ### clean [CLI shutdown](/api-reference/cli-shutdown/#clean) ### reset [CLI shutdown](/api-reference/cli-shutdown/#reset) ### Backups [CLI backups](/api-reference/cli-backups/#backups) ### Selecting a space [CLI spaces](/api-reference/cli-selection/#selecting-a-space) ### Mesh registry [CLI spaces](/api-reference/cli-selection/#mesh-registry) ### spawn [Agent launch reference](/api-reference/cli-agents/#spawn) ### models [Agent launch reference](/api-reference/cli-agents/#models) ### endpoints [CLI endpoints](/api-reference/cli-endpoints/#endpoints) ### who [CLI endpoints](/api-reference/cli-endpoints/#who) ### whoami [CLI endpoints](/api-reference/cli-endpoints/#whoami) ### Handle inspection [CLI endpoints](/api-reference/cli-endpoints/#handle-inspection) ### Account signer export [CLI endpoints](/api-reference/cli-endpoints/#account-signer-export) ### Endpoint authoring [CLI endpoints](/api-reference/cli-endpoints/#endpoint-authoring) ### Endpoint control [CLI endpoints](/api-reference/cli-endpoints/#endpoint-control) ### Managed seats [Agent terminal control](/api-reference/cli-agent-control/#managed-seats) ### input [Agent terminal control](/api-reference/cli-agent-control/#input) ### persona [Agent launch reference](/api-reference/cli-agents/#persona) ### supervise [Process supervision](/api-reference/cli-processes/#supervise) ### service [Local service reference](/api-reference/cli-services/#service) ### Adding a service [Local service reference](/api-reference/cli-services/#adding-a-service) ### Running a service [Local service reference](/api-reference/cli-services/#running-a-service) ### reconcile-gate [Manager maintenance](/api-reference/cli-maintenance/#reconcile-gate) ### endpoint deregister [CLI endpoints](/api-reference/cli-endpoints/#endpoint-deregister) ### runtimes [Agent launch reference](/api-reference/cli-agents/#runtimes) ### seats [Agent launch reference](/api-reference/cli-agents/#seats) ### send [CLI messaging](/api-reference/cli-messaging/#send) ### chat [CLI messaging](/api-reference/cli-messaging/#chat) ### The --stdio protocol [CLI messaging](/api-reference/cli-messaging/#the---stdio-protocol) ### channel [CLI messaging](/api-reference/cli-messaging/#channel) ### history [CLI messaging](/api-reference/cli-messaging/#history) ### console [CLI observation](/api-reference/cli-observation/#console) ### Web dashboard [CLI observation](/api-reference/cli-observation/#web-dashboard) ### linear [Linear integration](/api-reference/cli-integrations/#linear) ### Serving the endpoint [Linear integration](/api-reference/cli-integrations/#serving-the-endpoint) ### Callers [Linear integration](/api-reference/cli-integrations/#callers) ### pending [CLI messaging](/api-reference/cli-messaging/#pending) ### deliver [Local service reference](/api-reference/cli-services/#deliver) ### auth mint [CLI authentication](/api-reference/cli-auth/#auth-mint) ### Endpoint caller credentials [CLI authentication](/api-reference/cli-auth/#endpoint-caller-credentials) ### Login [CLI authentication](/api-reference/cli-auth/#login) ### actor [CLI authentication](/api-reference/cli-auth/#actor) ### doctor [CLI authentication](/api-reference/cli-auth/#doctor) ### join [CLI installation](/api-reference/cli-installation/#join) ### Manifest deploys [CLI startup](/api-reference/cli-startup/#manifest-deploys) ### ext [CLI installation](/api-reference/cli-installation/#ext) ### Built-in connectors are seeded extensions [CLI installation](/api-reference/cli-installation/#built-in-connectors-are-seeded-extensions) ### docs [CLI installation](/api-reference/cli-installation/#docs) ### config [CLI installation](/api-reference/cli-installation/#config) ### completion [CLI installation](/api-reference/cli-installation/#completion) ### feedback [CLI installation](/api-reference/cli-installation/#feedback) ### run [CLI workflow runs](/api-reference/cli-runs/#run) ### Server daemons [Local service reference](/api-reference/cli-services/#server-daemons) ### Plumbing [CLI authentication](/api-reference/cli-auth/#plumbing) ### watch [CLI observation](/api-reference/cli-observation/#watch) ### Named agent status [Agent view reference](/api-reference/cli-agent-views/#named-agent-status) ### Manager maintenance [Manager maintenance](/api-reference/cli-maintenance/#manager-maintenance) ### Workflow command forms [CLI workflow runs](/api-reference/cli-runs/#workflow-command-forms) ### Update availability [CLI installation](/api-reference/cli-installation/#update-availability) ### Account screens [CLI authentication](/api-reference/cli-auth/#account-screens) ### Managed launch view [Agent view reference](/api-reference/cli-agent-views/#managed-launch-view) ### Observer stream [CLI observation](/api-reference/cli-observation/#observer-stream) ### Recorded team views [Agent view reference](/api-reference/cli-agent-views/#recorded-team-views) ### Terminal input receipts [Agent terminal control](/api-reference/cli-agent-control/#terminal-input-receipts) ### Stopping an agent [Agent terminal control](/api-reference/cli-agent-control/#stopping-an-agent) ### Native endpoint reports [CLI endpoints](/api-reference/cli-endpoints/#native-endpoint-reports) ### Watch views [CLI observation](/api-reference/cli-observation/#watch-views) ### Authority [CLI authentication](/api-reference/cli-auth/#authority) ### Saved endpoint references [CLI endpoints](/api-reference/cli-endpoints/#saved-endpoint-references) ### Local service definitions [Local service reference](/api-reference/cli-services/#local-service-definitions) ### Service presets [Local service reference](/api-reference/cli-services/#service-presets) ### Native Linear service [Linear integration](/api-reference/cli-integrations/#native-linear-service) ### Native auth service [Local service reference](/api-reference/cli-services/#native-auth-service) ### Manager stop impact [Manager maintenance](/api-reference/cli-maintenance/#manager-stop-impact) ### Resolving endpoint targets [CLI endpoints](/api-reference/cli-endpoints/#resolving-endpoint-targets) ### Declared capabilities that remain gated [CLI endpoints](/api-reference/cli-endpoints/#declared-capabilities-that-remain-gated) ### Clearing retained history [CLI messaging](/api-reference/cli-messaging/#clearing-retained-history) ### Following an endpoint action [CLI endpoints](/api-reference/cli-endpoints/#following-an-endpoint-action) ### Unconfirmed requests [CLI endpoints](/api-reference/cli-endpoints/#unconfirmed-requests) ### Persona previews [Agent view reference](/api-reference/cli-agent-views/#persona-previews) ### Owned process services [Process supervision](/api-reference/cli-processes/#owned-process-services) ### Endpoint class scatters [CLI endpoints](/api-reference/cli-endpoints/#endpoint-class-scatters) ### Personas on an exact manager [Agent launch reference](/api-reference/cli-agents/#personas-on-an-exact-manager) ### Dashboard command [Dashboard command reference](/api-reference/cli-observation/#web) ### Channel seed file [Command reference](/api-reference/cli-startup/#channel-seed-file) ### manager [Command reference](/api-reference/cli-maintenance/#manager) ### Start a manager for a hosted space [Command reference](/api-reference/cli-maintenance/#start-a-manager-for-a-hosted-space) ### daemon [Command reference](/api-reference/cli-processes/#daemon) ### service-endpoint [Command reference](/api-reference/cli-endpoints/#service-endpoint) ### auth revoke-credential [Command reference](/api-reference/cli-auth/#auth-revoke-credential) ### telemetry [Command reference](/api-reference/cli-installation/#telemetry)