Troubleshooting and FAQ

The core is Tutti's background service. Run tutti status to see whether it's running, and tutti core start to start it. In the desktop app, quit and reopen Tutti; the app starts its own core.

Tutti drives agents you install yourself. Install at least one, for example Claude Code, Codex CLI or Gemini CLI, sign in to it once in a terminal, then reload Tutti. Settings → Agents & models shows which agents Tutti found.

Commands from tutti.toml run only after you approve them. Look for Review setup commands on the project and approve it. Then check the session's Logs tab for the setup script's output.

Use $TUTTI_PORT (and $TUTTI_PORT_1, $TUTTI_PORT_2…) in your dev server commands instead of fixed ports. Tutti gives every session its own ports, so they never clash.

Tutti uses the GitHub CLI. Install gh, run gh auth login once, and make sure the repository has an origin remote on GitHub.

If Windows SmartScreen shows "Windows protected your PC", choose More info, then Run anyway. You can check the download against its .sha256 file first.

Automatic checks slow down while nothing changes and stop at a daily limit; the board says when the next check is. Use Sync now on the board, and make sure the tracker's MCP server still works in Claude Code or Codex.

Finish signing in in your browser; the app updates by itself. If it doesn't, choose Open the sign-in page again. On a machine without a browser, run tutti login --device and enter the code on another device.

Yes, for individuals, with every feature. You bring your own agent subscriptions or API keys, so you pay your model providers directly and Tutti adds nothing on top. Companies pay per member for shared teams, central billing and admin.

No. Agents run on your computer and talk to their model providers directly. Your Tutti account stores your email, your devices and your settings. Code, prompts, diffs and terminal output are never sent to Tutti.

Claude Code, OpenAI Codex CLI, Gemini CLI, OpenCode and Aider work out of the box, and any other command-line agent can be added in tutti.toml. Each teammate can use a different agent and model.

macOS (Apple silicon and Intel, macOS 12 or newer), Windows 10 and 11, and Linux (x64 and ARM64, .deb and .rpm), as a desktop app. The core and the tutti command line tool also install with one command.

Yes. Sign in with GitHub, Google or your email the first time you open Tutti. The account is free; it keeps your devices and settings and confirms your plan. The app keeps working offline for a while and checks in when you're back online.

They can't touch it. Every piece of work runs in its own git worktree on its own branch. Nothing is pushed, merged or deleted unless you say so, and Tutti saves a checkpoint after each agent turn so you can roll back.

Yes, through the tools you've already connected to Claude Code or Codex (MCP servers). Pick the server, choose the board, and Tutti mirrors its open tickets onto the project's board. When a teammate takes, finishes or gets a card approved, the ticket moves there too.

No. There are ready-made teams for marketing (researcher, copywriter, SEO, editor), sales (researcher, outreach writer) and research (researchers and an analyst). Point Tutti at any folder; it keeps each teammate's work in its own copy, just like code.

Yes. Each teammate keeps notes across cards: how to run your tests, where things are, what you prefer. They add to them as they work and when you approve a card, and you can read, edit or undo them any time.

No. Tutti looks at your project, recognises frameworks like Django, Next.js, Vite and Rails, and proposes a tutti.toml: dependencies, ports per agent, dev servers. You review it once, and every agent gets a working environment.