The developer path

1. Claude Code

npm install -g @anthropic-ai/claude-code && claude

Sign in when it asks, then type /exit to leave the chat. If npm is not found, install Node first from nodejs.org.

2. Torta

npm install -g torta-ai

torta-ai is the installable alias for torta-app, which carries the CLI, the board and the engine. Both are published at the same version.

3. Start it

torta start

With no workspace in the folder, torta start serves the setup wizard and rolls into the board of the workspace it creates. Pointed at a workspace, it opens that board:

torta start ~/Documents/projects/my-project

torta start serves 127.0.0.1 only, on port 5599 by default, and opens your browser. It also runs the engine, which starts an agent when work you approved arrives. Ctrl-C stops the board, the engine and every pane.

Useful flags:

• --port <n> to move off 5599.
• --no-open to skip opening a browser.
• --no-engine for a board with nothing behind it.
• --runner stub|sdk|pty|auto to pick how sessions run. The default is auto.

The full list is in the CLI reference.

4. Answer the questions

The wizard asks six questions, ending with the first thing you want built. The location comes filled in as ~/Documents/projects/<your-project-name>. Type over it, or press choose project path and pick a folder. Torta creates the folder, so pick a place that does not have one.

Nothing is written to disk until you press create workspace.

Skip the browser

torta init asks the same questions in the terminal, and --yes takes the default for every question that has one. For no questions at all:

torta init my-project --ios --backend --preset solo

Platforms are opt-in. Turning one off removes its repo, its agent’s home, its wall and its queue.

Next

Your first ticket covers what to do on the board.