RepospecThe repository is the source of truth — not the AI.

An open, repository-first specification that standardizes how AI coding assistants understand, build, and evolve a project — without prompts.

Get started

Why Repospec

The Specification

One source, every assistant

Author a single .repospec/ directory. Adapters project it into AGENTS.md, CLAUDE.md, Cursor, Copilot, Windsurf, Gemini, Zed, Cline, and Continue — plus native Claude Code subagents — kept in sync with one command.

A standard, not a tool

The Specification is language-neutral and versioned independently of the reference CLI. If the CLI vanished, any tool built against the spec would still stand.

Owned by humans, generated by machine

You edit .repospec/; Repospec regenerates the tool entrypoints. Generated files carry a managed checksum and are never clobbered when you hand-edit them.

Opt-in, sandboxed plugins

Community plugins run only after explicit, integrity-pinned consent — in a subprocess under Node's Permission Model with no filesystem access and capability-gated network.

Quickstart

bash

# run without installing
npx @repospec/cli init

# validate and keep entrypoints in sync
repospec doctor
repospec sync
repospec sync --check   # CI: fail if entrypoints drift from .repospec/

repospec init writes the human-owned .repospec/ source of truth and the Repospec-owned tool entrypoints. Edit .repospec/, then run repospec sync to update every assistant's file at once.

New here? Follow the getting-started guide — from scratch or adopt in an existing project. Keep the command reference handy, and read the Specification to implement it in any language.