---
title: CLI reference
description: Find command syntax, flags, receipts, and limits for the Cotal CLI.
kind: "Reference: describes the TypeScript reference implementation (the `cotal` CLI), not the wire contract."
audience: operators
---

import { Card, Cards } from 'fumadocs-ui/components/card';

Use `cotal help <command>` for the flags supported by your installed version.
For a first local mesh, start with the [Quickstart](getting-started.mdx).

## Choose a reference

<Cards>
<Card title="Workstation">

- [CLI usage](cli-usage.mdx)
- [CLI installation](cli-installation.mdx)
- [CLI spaces](cli-selection.mdx)

</Card>
<Card title="Mesh lifecycle">

- [CLI startup](cli-startup.mdx)
- [CLI shutdown](cli-shutdown.mdx)
- [CLI backups](cli-backups.mdx)

</Card>
<Card title="Agents">

- [Agent launch reference](cli-agents.mdx)
- [Agent terminal control](cli-agent-control.mdx)
- [Agent view reference](cli-agent-views.mdx)

</Card>
<Card title="Services">

- [Local service reference](cli-services.mdx)
- [Process supervision](cli-processes.mdx)
- [Manager maintenance](cli-maintenance.mdx)
- [Linear integration](cli-integrations.mdx)

</Card>
<Card title="Communication">

- [CLI endpoints](cli-endpoints.mdx)
- [CLI messaging](cli-messaging.mdx)
- [CLI observation](cli-observation.mdx)

</Card>
<Card title="Authority and workflows">

- [CLI authentication](cli-auth.mdx)
- [CLI workflow runs](cli-runs.mdx)

</Card>
</Cards>

## Find a command

Each entry links to its full syntax and behavior.

### Running it [#running-it]

[CLI usage](cli-usage.mdx#running-it)

### Structured output [#structured-output]

[CLI usage](cli-usage.mdx#structured-output)

### Commands [#commands]

[CLI usage](cli-usage.mdx#commands)

### setup [#setup]

[CLI installation](cli-installation.mdx#setup)

### update [#update]

[CLI installation](cli-installation.mdx#update)

### up [#up]

[CLI startup](cli-startup.mdx#up)

### down [#down]

[CLI shutdown](cli-shutdown.mdx#down)

### clean [#clean]

[CLI shutdown](cli-shutdown.mdx#clean)

### reset [#reset]

[CLI shutdown](cli-shutdown.mdx#reset)

### Backups [#backups]

[CLI backups](cli-backups.mdx#backups)

### Selecting a space [#selecting-a-space]

[CLI spaces](cli-selection.mdx#selecting-a-space)

### Mesh registry [#mesh-registry]

[CLI spaces](cli-selection.mdx#mesh-registry)

### spawn [#spawn]

[Agent launch reference](cli-agents.mdx#spawn)

### models [#models]

[Agent launch reference](cli-agents.mdx#models)

### endpoints [#endpoints]

[CLI endpoints](cli-endpoints.mdx#endpoints)

### who [#who]

[CLI endpoints](cli-endpoints.mdx#who)

### whoami [#whoami]

[CLI endpoints](cli-endpoints.mdx#whoami)

### Handle inspection [#handle-inspection]

[CLI endpoints](cli-endpoints.mdx#handle-inspection)

### Account signer export [#account-signer-export]

[CLI endpoints](cli-endpoints.mdx#account-signer-export)

### Endpoint authoring [#endpoint-authoring]

[CLI endpoints](cli-endpoints.mdx#endpoint-authoring)

### Endpoint control [#endpoint-control]

[CLI endpoints](cli-endpoints.mdx#endpoint-control)

### Managed seats [#managed-seats]

[Agent terminal control](cli-agent-control.mdx#managed-seats)

### input [#input]

[Agent terminal control](cli-agent-control.mdx#input)

### persona [#persona]

[Agent launch reference](cli-agents.mdx#persona)

### supervise [#supervise]

[Process supervision](cli-processes.mdx#supervise)

### service [#service]

[Local service reference](cli-services.mdx#service)

### Adding a service [#adding-a-service]

[Local service reference](cli-services.mdx#adding-a-service)

### Running a service [#running-a-service]

[Local service reference](cli-services.mdx#running-a-service)

### reconcile-gate [#reconcile-gate]

[Manager maintenance](cli-maintenance.mdx#reconcile-gate)

### endpoint deregister [#endpoint-deregister]

[CLI endpoints](cli-endpoints.mdx#endpoint-deregister)

### runtimes [#runtimes]

[Agent launch reference](cli-agents.mdx#runtimes)

### seats [#seats]

[Agent launch reference](cli-agents.mdx#seats)

### send [#send]

[CLI messaging](cli-messaging.mdx#send)

### chat [#chat]

[CLI messaging](cli-messaging.mdx#chat)

### The --stdio protocol [#the---stdio-protocol]

[CLI messaging](cli-messaging.mdx#the---stdio-protocol)

### channel [#channel]

[CLI messaging](cli-messaging.mdx#channel)

### history [#history]

[CLI messaging](cli-messaging.mdx#history)

### console [#console]

[CLI observation](cli-observation.mdx#console)

### Web dashboard [#web-dashboard]

[CLI observation](cli-observation.mdx#web-dashboard)

### linear [#linear]

[Linear integration](cli-integrations.mdx#linear)

### Serving the endpoint [#serving-the-endpoint]

[Linear integration](cli-integrations.mdx#serving-the-endpoint)

### Callers [#callers]

[Linear integration](cli-integrations.mdx#callers)

### pending [#pending]

[CLI messaging](cli-messaging.mdx#pending)

### deliver [#deliver]

[Local service reference](cli-services.mdx#deliver)

### auth mint [#auth-mint]

[CLI authentication](cli-auth.mdx#auth-mint)

### Endpoint caller credentials [#endpoint-caller-credentials]

[CLI authentication](cli-auth.mdx#endpoint-caller-credentials)

### Login [#login]

[CLI authentication](cli-auth.mdx#login)

### actor [#actor]

[CLI authentication](cli-auth.mdx#actor)

### doctor [#doctor]

[CLI authentication](cli-auth.mdx#doctor)

### join [#join]

[CLI installation](cli-installation.mdx#join)

### Manifest deploys [#manifest-deploys]

[CLI startup](cli-startup.mdx#manifest-deploys)

### ext [#ext]

[CLI installation](cli-installation.mdx#ext)

### Built-in connectors are seeded extensions [#built-in-connectors-are-seeded-extensions]

[CLI installation](cli-installation.mdx#built-in-connectors-are-seeded-extensions)

### docs [#docs]

[CLI installation](cli-installation.mdx#docs)

### config [#config]

[CLI installation](cli-installation.mdx#config)

### completion [#completion]

[CLI installation](cli-installation.mdx#completion)

### feedback [#feedback]

[CLI installation](cli-installation.mdx#feedback)

### run [#run]

[CLI workflow runs](cli-runs.mdx#run)

### Server daemons [#server-daemons]

[Local service reference](cli-services.mdx#server-daemons)

### Plumbing [#plumbing]

[CLI authentication](cli-auth.mdx#plumbing)

### watch [#watch]

[CLI observation](cli-observation.mdx#watch)

### Named agent status [#named-agent-status]

[Agent view reference](cli-agent-views.mdx#named-agent-status)

### Manager maintenance [#manager-maintenance]

[Manager maintenance](cli-maintenance.mdx#manager-maintenance)

### Workflow command forms [#workflow-command-forms]

[CLI workflow runs](cli-runs.mdx#workflow-command-forms)

### Update availability [#update-availability]

[CLI installation](cli-installation.mdx#update-availability)

### Account screens [#account-screens]

[CLI authentication](cli-auth.mdx#account-screens)

### Managed launch view [#managed-launch-view]

[Agent view reference](cli-agent-views.mdx#managed-launch-view)

### Observer stream [#observer-stream]

[CLI observation](cli-observation.mdx#observer-stream)

### Recorded team views [#recorded-team-views]

[Agent view reference](cli-agent-views.mdx#recorded-team-views)

### Terminal input receipts [#terminal-input-receipts]

[Agent terminal control](cli-agent-control.mdx#terminal-input-receipts)

### Stopping an agent [#stopping-an-agent]

[Agent terminal control](cli-agent-control.mdx#stopping-an-agent)

### Native endpoint reports [#native-endpoint-reports]

[CLI endpoints](cli-endpoints.mdx#native-endpoint-reports)

### Watch views [#watch-views]

[CLI observation](cli-observation.mdx#watch-views)

### Authority [#authority]

[CLI authentication](cli-auth.mdx#authority)

### Saved endpoint references [#saved-endpoint-references]

[CLI endpoints](cli-endpoints.mdx#saved-endpoint-references)

### Local service definitions [#local-service-definitions]

[Local service reference](cli-services.mdx#local-service-definitions)

### Service presets [#service-presets]

[Local service reference](cli-services.mdx#service-presets)

### Native Linear service [#native-linear-service]

[Linear integration](cli-integrations.mdx#native-linear-service)

### Native auth service [#native-auth-service]

[Local service reference](cli-services.mdx#native-auth-service)

### Manager stop impact [#manager-stop-impact]

[Manager maintenance](cli-maintenance.mdx#manager-stop-impact)

### Resolving endpoint targets [#resolving-endpoint-targets]

[CLI endpoints](cli-endpoints.mdx#resolving-endpoint-targets)

### Declared capabilities that remain gated [#declared-capabilities-that-remain-gated]

[CLI endpoints](cli-endpoints.mdx#declared-capabilities-that-remain-gated)

### Clearing retained history [#clearing-retained-history]

[CLI messaging](cli-messaging.mdx#clearing-retained-history)

### Following an endpoint action [#following-an-endpoint-action]

[CLI endpoints](cli-endpoints.mdx#following-an-endpoint-action)

### Unconfirmed requests [#unconfirmed-requests]

[CLI endpoints](cli-endpoints.mdx#unconfirmed-requests)

### Persona previews [#persona-previews]

[Agent view reference](cli-agent-views.mdx#persona-previews)

### Owned process services [#owned-process-services]

[Process supervision](cli-processes.mdx#owned-process-services)

### Endpoint class scatters [#endpoint-class-scatters]

[CLI endpoints](cli-endpoints.mdx#endpoint-class-scatters)

### Personas on an exact manager [#personas-on-an-exact-manager]

[Agent launch reference](cli-agents.mdx#personas-on-an-exact-manager)

### Dashboard command [#web]

[Dashboard command reference](cli-observation.mdx#web)

### Channel seed file [#channel-seed-file]

[Command reference](cli-startup.mdx#channel-seed-file)

### manager [#manager]

[Command reference](cli-maintenance.mdx#manager)

### Start a manager for a hosted space [#start-a-manager-for-a-hosted-space]

[Command reference](cli-maintenance.mdx#start-a-manager-for-a-hosted-space)

### daemon [#daemon]

[Command reference](cli-processes.mdx#daemon)

### service-endpoint [#service-endpoint]

[Command reference](cli-endpoints.mdx#service-endpoint)

### auth revoke-credential [#auth-revoke-credential]

[Command reference](cli-auth.mdx#auth-revoke-credential)

### telemetry [#telemetry]

[Command reference](cli-installation.mdx#telemetry)