Documentation without detours.

Install the CLI, author portable specs under .agnostic-ai/, run agnostic-ai sync, and use your tools. Start fresh or bring an existing setup without losing its local behavior.

Install agnostic-ai Start with one rule Bring an existing setup

Set up agnostic-ai with a coding agent

Give a coding agent one safe workflow to install, import, configure, sync, and verify agnostic-ai in any repository.

Open the agent instructions Read the setup guide

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, import native configuration before syncing, and 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, verify, upgrade, and configure shell completion for agnostic-ai. Set up agnostic-ai with a coding agentGive a coding agent one safe workflow to install, import, configure, sync, and verify agnostic-ai in any repository. Getting startedInstall agnostic-ai and sync one rule to two AI coding tools. Import existing tool configurationBring an existing AI tool setup into agnostic-ai without losing local behavior.

Workflows

Directory-specific instructionsKeep rules close to the directories where they apply across supported tools. CIDetect generated-output drift and keep project configuration consistent in automation. Git hooksRun sync checks around commits and checkouts with common hook tools. Spec packsInstall, update, and layer reusable bundles of agnostic-ai specs. GraphVisualize which specs reach which targets and inspect the delivery graph. Trace generated filesExplain which specs produced a generated file and why it exists. Release and AI tooling updatesUnderstand release briefings, upstream evidence, and target capability classifications.

Reference

Spec formatDefine agents, skills, rules, hooks, MCP servers, commands, settings, and other portable specs. TargetsCompare supported tools, capability coverage, native output paths, and target-specific behavior. ConfigurationConfigure sources, targets, output overrides, sync behavior, imports, and global defaults. CLI referenceLook up every agnostic-ai command, option, and exit behavior. Error codesUnderstand every AAI diagnostic and the action that resolves it. TroubleshootingDiagnose configuration, sync, scope, and generated-output problems. Why not symlinks or manual copies?See where native formats diverge and when agnostic-ai is worth using.