RepoOSThe repo is the operating system.

Tasks are markdown files in your repo. AI agents work them in git worktrees. You stay at the sign-off gate.

Install into any repo

RepoOS isn't a hosted service or a place you move your work to. Run repoos init inside a repo you already have, and it adds work/, docs/, and an AGENTS.md.

Install and initialize

Tasks are files, status is a field

Every task is a markdown file under work/ with its status in YAML frontmatter — inbox, ready, active, review, done. Edited in place, versioned by git, no board database to lose.

How tasks work

Agents work in isolation

Each task gets its own git worktree and branch. Agents run there, never on your main checkout, and nothing merges until the check gate is green and you sign off.

The task lifecycle

Local-first, zero lock-in

Runs on your machine. Source-available, zero runtime dependencies. Your tasks are markdown in your repo — leaving means deleting one directory.

Configure it