Documentation.
Write specs once under .agnostic-ai/, run agnostic-ai sync, and each tool gets its own config. Start fresh, or import an existing setup and keep its behavior.
Set up agnostic-ai with a coding agent
Paste one prompt into your coding agent, and it sets agnostic-ai up in about two minutes.
Paste into your coding agent
Set up agnostic-ai in this repository. Follow https://agnostic-ai.org/agent-setup.txt exactly. Preserve existing AI tool behavior. Before any sync, check for existing CLAUDE.md, AGENTS.md, and similar files, and ask me what to do with their content. Finish with agnostic-ai sync --check. Summarize the targets selected and every file changed.Find the guide for the job.
Read one path end to end, or jump straight to a reference.
Start
InstallationInstall agnostic-ai on macOS, Linux, or Windows, then verify and upgrade it. Verify a releaseCheck that the agnostic-ai binary you install is the one this repository's release workflow built, before you run it. Set up agnostic-ai with a coding agentPaste one prompt into your coding agent, and it sets agnostic-ai up in about two minutes. Getting startedInstall agnostic-ai, import existing tool files, preview the changes, and sync. Import existing tool configurationImport an existing AI tool setup into agnostic-ai and keep its behavior.
Workflows
Directory-specific instructionsKeep rules close to the directories where they apply across supported tools. CICatch drift between specs and generated output in CI. Git hooksRun sync checks around commits, checkouts, and pulls with pre-commit, lefthook, or husky. Spec packsInstall, update, and layer reusable bundles of agnostic-ai specs. Local overridesKeep personal specs and instructions on top of the shared ones, out of Git, per project or per machine. Session handoffsWrite a portable session handoff and resume work in another AI tool on the same machine. GraphSee which specs reach which targets, and which files they produce. Trace generated filesTrace a generated file back to the specs and adapter that produced it. Release and AI tooling updatesHow each release announcement records reader impact, upstream evidence, and target capability classifications.
Reference
Spec formatWhat each folder under .agnostic-ai/ holds, and the conventions every spec shares. CLI referenceLook up every agnostic-ai command, option, and exit behavior. Compare targetsSee side by side what agnostic-ai writes for two or three AI coding tools. Cross-target behaviorUnderstand shared entry points, global output paths, and behavior that spans multiple AI tools. ConfigurationConfigure sources, targets, output overrides, sync behavior, imports, and global defaults. Error codesEvery AAI-NNN diagnostic, what causes it, and the fix. TroubleshootingDiagnose configuration, sync, scope, and generated-output problems. Why agnostic-aiEvery AI coding tool wants its own config files. Why symlinks, copies, one AGENTS.md, or a script fall short, and what agnostic-ai does instead.
Watch it run. The talk demo.
Twenty minutes from one spec to native files for every target.
