Get started · Beginner

Get started in one command

Paste a prompt into Claude Code, or run one command. Either starts a local space with an agent.

Install

Ask Claude Code or run one command. Copy one below.

A prompt pasted into Claude Code: it follows docs.cotal.ai/prompt.md, runs the setup commands and starts a local space with an agent on it. The tab switches to a terminal that runs curl -fsSL https://get.cotal.ai | sh. Cotal installs, setup asks where the space runs, the agent app, runtimes, project folder and space name, the space starts and Claude Code opens.

demo · Get started in one command28 s

Claude Code reads the page and runs npx cotal-ai setup, npx cotal-ai up and npx cotal-ai spawn. Then it reports that the space is running with an agent.

Read https://docs.cotal.ai/prompt.md, then set up Cotal here: start a local space and put an agent on it.

The installer checks the machine and installs Cotal. Guided setup asks where the space runs, the agent app, the runtimes, the project folder and the space name. After Yes, the space starts and Claude Code opens.

curl -fsSL https://get.cotal.ai | sh

Paste a prompt into Claude Code.

Docs: Quick start

Use your existing setup

Your space is running. Pick where your agents run.

Your terminal

Your terminal, with Claude Code, Codex, OpenCode or another agent app.

When an agent joins

The agent starts in this terminal, already in the space.