agentinit 0.3.11

Scaffold agent context files into a project.

agentinit

Scaffold and maintain agent context files for modern coding assistants, with a deterministic, standard-library-only CLI.

agentinit creates a clean router-first setup around AGENTS.md, plus companion files for Claude, Cursor, Copilot, Gemini CLI, and llms.txt.

Why agentinit 🎯

• Single source of truth: keep high-level rules in AGENTS.md.
• Low drift workflow: regenerate and verify router files with sync --check.
• Lean context model: keep short entry files and push detail into docs/.
• No runtime dependencies: pure Python stdlib.

Quick Start 🚀

Requires Python 3.10+.

# Install (recommended)
pipx install agentinit

# Initialize in an existing repository
cd your-project
agentinit init --minimal

Minimal profile generates:

your-project/
├── llms.txt
├── AGENTS.md
├── CLAUDE.md
└── docs/
    ├── PROJECT.md
    └── CONVENTIONS.md

Full profile (agentinit init) also includes GEMINI.md, docs/STATE.md, docs/TODO.md, docs/DECISIONS.md, Cursor/Copilot/Claude rule files, and .contextlintrc.json.

Core Workflow 🧭

# 1) Bootstrap context files
agentinit init --detect --purpose "AI code review assistant"

# 2) Keep llms.txt aligned with project docs
agentinit refresh-llms

# 3) Add modular resources
agentinit add skill code-reviewer
agentinit add mcp github
agentinit add security

# 4) Validate quality gates
agentinit status --check
agentinit sync --check
agentinit lint

For minimal projects, both status --check and sync --check auto-detect the generated minimal profile. status --minimal --check and sync --minimal --check remain available if you want to force that mode explicitly.

Command Reference

• agentinit init add missing context files in current directory
• agentinit minimal shortcut for init --minimal
• agentinit new <project> create a new project and scaffold context
• agentinit refresh-llms (alias: refresh) regenerate llms.txt
• agentinit sync reconcile router files from templates
• agentinit status show missing/incomplete files and line budgets
• agentinit lint run contextlint checks
• agentinit add <type> <name> install resources (skill, mcp, security, soul)
• agentinit remove remove or archive managed files

CI Example ✅

Use both structure and drift checks:

agentinit sync --check
agentinit status --check
agentinit lint

Tool Compatibility 🤝

agentinit is designed to work with common agentic workflows by generating:

• AGENTS.md as primary router
• CLAUDE.md for Claude Code memory/routing
• .cursor/rules/project.mdc for Cursor rule routing
• .github/copilot-instructions.md for GitHub Copilot context
• GEMINI.md for Gemini CLI context routing
• llms.txt as project discovery index

Troubleshooting 🛠️

If your agent cannot find context files:

• track files in git (git add AGENTS.md CLAUDE.md GEMINI.md llms.txt docs/)
• verify ignored files (git status --ignored)
• regenerate derived files (agentinit refresh-llms and agentinit sync)
• replace managed symlinks with regular files inside the repo; unsafe managed paths are skipped by design

Documentation 📚

Wiki (full usage and examples):

• Changelog
• Wiki Home
• Quick Start
• Commands
• Workflows
• Troubleshooting
• FAQ
• Contributing to the Wiki

Development 🧪

python3 -m venv .venv
. .venv/bin/activate
pip install -e . --group dev
python3 -m ruff check agentinit tests cli
python3 -m ruff format --check agentinit tests cli
python3 -m pytest tests/ -v

On distro-managed Python installs that enforce PEP 668, run the development commands inside a virtual environment instead of the system interpreter.

License

MIT