Skip to content
Spec{0}

Create your first project

A Spec0 project is a local git repository. Spec0 manages cards, tasks, and history for that repo; it never touches the files inside it. Agents read and write the repo through their own tooling.

Add a project

  1. Open Spec0.
  2. Click the + next to Projects in the sidebar, or use ⌘N then New project.
  3. Pick the folder that contains the git work tree you want to plan against.

If the folder isn’t a git repo, Spec0 will refuse it — git init first, then try again.

What happens

Spec0 creates a tiny per-project database under ~/Library/Application Support/Spec0/projects/<id>/. No files are added inside your repo. No git remote is created. No hooks are installed.

The project now appears in the sidebar with its initial board: Drafts, Inbox, Todo, Doing, Review, Done.

Set a verification guide

Open Settings → Projects → Verification for the new project. The verification guide is a short markdown document that describes how proof of work is shown for this repo — e.g. “run pnpm check and paste the output,” “attach a screenshot of the relevant screen.” Agents read this guide when picking proof methods for the cards they claim.

A short, specific guide beats a long generic one. You can edit it any time.

Next