ai-agent-kit

ai-agent-kit

Quick install

Clone the repository and run the local installer. This is the supported install path today — it works on a fresh clone with no published release required.

# Unix / macOS — installs codex, claude, and agy into the target project
git clone https://github.com/PetrovC/ai-agent-kit.git
cd ai-agent-kit
./scripts/install.sh --target /path/to/your-project --tools codex,claude,agy

# Windows PowerShell — installs codex, claude, and agy into the target project
git clone https://github.com/PetrovC/ai-agent-kit.git
cd ai-agent-kit
.\scripts\install.ps1 -Target "C:\path\to\your-project" -Tools codex,claude,agy

Omit --tools / -Tools to install all three tools by default. See Quick start for profiles, the plugin marketplace alternative, and Windows ExecutionPolicy notes.

Released install (available from v1.22.1)

Requires a published GitHub release. The one-liners below download a release artifact (bootstrap.{sh,ps1}) and run the installer; until a release is published they return HTTP 404 — use the local install above.

# Unix / macOS — installs codex, claude, and agy into the current directory
curl -fsSL https://github.com/PetrovC/ai-agent-kit/releases/latest/download/bootstrap.sh | bash

# Windows PowerShell — installs codex, claude, and agy into the current directory
irm https://github.com/PetrovC/ai-agent-kit/releases/latest/download/bootstrap.ps1 | iex

Both commands download the latest release artifact and run the local installer. Pass explicit options to control what is installed (see Quick start):

curl -fsSL https://github.com/PetrovC/ai-agent-kit/releases/download/v1.23.0/bootstrap.sh \
  | bash -s -- --target /path/to/project --tools claude --version v1.23.0

& ([scriptblock]::Create((irm 'https://github.com/PetrovC/ai-agent-kit/releases/latest/download/bootstrap.ps1'))) `
    -Target '.\target-project' -Tools 'claude,codex,agy'

A reusable, versioned AI agent configuration kit for Claude Code, Codex CLI, and Antigravity CLI.

Philosophy

• One skill is written once and deployed to all tools.
• Root instruction files (AGENTS.md, CLAUDE.md, AGY.md) are short routers, not encyclopedias.
• Project context lives in docs/ai/ inside each project — not in this kit.
• Subagents handle noisy, exploratory, or parallel work to protect the main context window.

This repository intentionally dogfoods the kit for Claude Code, Codex CLI, and Antigravity CLI: AGENTS.md, CLAUDE.md, AGY.md, .agents/, .claude/, .codex/, .agy/, .agyignore, .mcp.json, .mcp.example.jsonc, .kit-version, .kit-manifest, and docs/ai/ are tracked here as project-local configuration (CI requires them — see the dogfood install policy in .github/workflows/pr-versioning.yml). Claude local/runtime files (CLAUDE.local.md, .claude/settings.local.json, .claude/session-log/, .claude/worktrees/) stay ignored.

---

Contributing

Start with CONTRIBUTING.md for the issue-first workflow, branch and commit conventions, Definition of Done, and local validation commands.

---

Choose Your Install

Path	Use when	What it installs
Install script	You want the full kit for Claude Code, Codex CLI, Antigravity CLI, or more than one tool.	Tool routers, shared skills, commands, agents, hooks where supported, MCP examples, and docs/ai/ project context.
Claude plugin marketplace	You only use Claude Code and want the skills slice with no project scaffolding.	Namespaced Claude skills only. Run /plugin marketplace add PetrovC/ai-agent-kit, then /plugin install ai-agent-kit@ai-agent-kit.
Antigravity extension scaffold	You are building a custom Antigravity CLI extension distribution.	A maintained starting point under tooling/agy/; the script remains the canonical full install path.

Tool x OS Support