Command line

The tutti command comes with every install. It talks to the Tutti core, the background service that runs your agents, and is handy on servers and in scripts.

Commands

Command	What it does
`tutti status`	Show whether a core is running, and its version.
`tutti open`	Open Tutti in your browser. Prints a one-time login link.
`tutti open --no-browser`	Only print the link; don't launch a browser (servers, SSH).
`tutti login`	Sign in to your Tutti account; opens a browser.
`tutti login --device`	Sign in with a one-time code you enter on another device, for machines without a browser.
`tutti logout`	Sign out on this machine. Local work is untouched.
`tutti whoami`	Show the signed-in account.
`tutti init [path]`	Detect the repository's stack and print a proposed tutti.toml (default: the current folder).
`tutti init --write`	Save the proposal as tutti.toml in the repository root.
`tutti init --write --force`	Overwrite an existing tutti.toml.
`tutti core start`	Start the core (Tutti's background service) if it isn't running.
`tutti core stop`	Stop the running core gracefully.
`tutti --version`	Print the version.
`tutti help [command]`	Help for any command.

Every command takes --data-dir <path> (or TUTTI_DATA_DIR) to talk to a core with a different data folder.

Examples

Set up a repository from a terminal

cd ~/code/acme-shop
tutti init              # look at the proposal
tutti init --write      # save it as tutti.toml
tutti open              # open Tutti and add the project

A machine without a desktop

curl -fsSL https://tutti.build/install.sh | sh
tutti login --device    # enter the code shown on another device
tutti core start
tutti open --no-browser # prints a one-time link

The core listens only on 127.0.0.1. To use it from your laptop, forward its port over SSH and open the printed link. Remote access from other devices and your phone is coming soon.

Is it running?

tutti status
tutti core stop && tutti core start   # restart it

Environment variables

Variable	What it does
`TUTTI_DATA_DIR`	Use a different data folder.
`TUTTI_KEYSTORE=file`	Keep the sign-in token in a private file instead of the system keychain (for servers without one).
`TUTTI_CLAUDE_BIN`, `TUTTI_GIT`	Use a specific `claude` or `git` binary.
`TUTTI_INSTALL_DIR`	Installer: where to install (default `~/.tutti/bin`, or `%LOCALAPPDATA%\Tutti\bin` on Windows).
`TUTTI_NO_MODIFY_PATH=1`	Installer: don't change your shell's PATH.
`TUTTI_VERSION`	Installer: install a specific version instead of the latest.
`TUTTI_NO_START=1`	Installer: don't start Tutti afterwards.

Something missing or unclear? Ask us, and we'll answer and improve this page.