Tortilloid
Getting started / Install and first launch

Docs / Getting started / Install and first launch

Install and first launch

Get Tortilloid running on your Mac and open your first project.

Before you start

  • A Mac with Apple silicon, M1 or later.
  • 8 GB of memory, 16 GB recommended.
  • A beta key, from your invite to the private beta. Request an invite if you don't have one yet.

Install

  1. Go to the Download page and enter your beta key. New versions only ever come from that page.
  2. Download Tortilloid, open the download and drag Tortilloid into Applications.
  3. Open Tortilloid and enter your beta key when asked. The app locks to that key. See Your beta account.

First launch

Each time Tortilloid opens, it checks that your key and this beta build are still valid. If all is well, you see nothing. Otherwise a window explains what to do.

You seeWhat to do
Enter your beta key.Paste the key from your invite. Lost it?
That key is already on two Macs.Free up a Mac, or ask us to. See Moving to a new Mac.
This key has been turned off.Enter another key if you have one, or write to us.
This beta expires in a few days.A reminder only. Download the latest beta when you can.
An online check is needed.Reconnect to the internet and reopen Tortilloid.
This beta has expired, or is no longer active.Download the latest beta. Replacing the app keeps your projects and history.

The first time you open a build, Before you start. shows the beta terms. Click Accept and continue, or Decline to quit. You are only asked again when the build or the terms change.

Setup cards

A few short cards introduce Tortilloid, then help you set up. You can Skip intro or Skip setup at any time.

  • Kongo key. Paste a key for OpenAI, Anthropic or OpenCode Zen, or skip it. See API keys.
  • Your agents. Connect Claude Code or Codex if they are installed. See Connect your agents.
  • Free Agent. Always on, and needs no key. See Free Agent.
  • All set. Checks each key you saved, and whether the Kongo engine is installed. If it isn't yet, it installs the first time you use Kongo.

Open a project

  • Open a project. Choose any folder. Your files stay exactly where they are, and you can keep using your usual editor alongside Tortilloid.
  • Start something new. Kongo helps shape the idea, sets up the project and starts building it with you.
  • Clone a repo. Paste a link and start working. Tortilloid never touches your Git data.

Later, use File › Open… (Cmd+O) or File › Open Recent.

The first time a project opens, Tortilloid starts recording. Every change, by you or any agent, lands in the project's history. Cards then offer to scan the project for Knowledge, to follow Git if the folder is a repository, and to add a Tortilloid guide to each agent's instruction file.

What Tortilloid adds

One folder, .tortilloid, at the project root. Your own files are never moved or renamed. What's inside is listed in What stays on your Mac.

Updates

Tortilloid checks for a newer beta shortly after launch and once a day. To check now, choose Tortilloid › Check for Updates….