Skip to content
ttorta docs

Knowledge Base

Reopen a project

Point torta at the folder it made, and it picks up where you left off.


A workspace is files on your disk, and the board is drawn from them each time it starts.

Stopping

Ctrl-C in the terminal you started torta in stops the board, the engine and every pane. A second Ctrl-C exits immediately.

Sessions already running under a standalone torta watch are left to finish.

Opening it again

Point torta at the folder:

torta start ~/Documents/projects/my-project

Or, if you never installed it globally:

npx -y torta-ai start ~/Documents/projects/my-project

A bare torta start inside a workspace opens that board. Anywhere else it serves the setup wizard.

What comes back, and what does not

Comes back:

  • every queue, every ticket, every status
  • the decisions waiting on you
  • the pause switch, if you left it paused
  • the settings tab, re-probed when you open it

Does not come back:

  • the panes. There is no reattach across restarts. Click an agent to open a fresh one.

The address

The board serves 127.0.0.1 only, on port 5599 by default. The terminal prints the address, and the browser opens unless you passed --no-open.

If port 5599 is taken, torta says so and suggests --port <n>.

Opening a second project

Two boards can run at once on different ports:

torta start ~/Documents/projects/other-project --port 5600

Each board watches its own workspace and holds its own engine.