Install Into Project

How to install agent-toolkit into a project

Note

Goal: Get every shipped customization (pii-scrubber, dependabot-fixer, ship-release, example-bundle) into a target project's host paths, plus the pre-push PII guardrail. Prereqs: agent-toolkit cloned somewhere on your machine; target project exists and is a git repo (for the pre-push hook).

Steps

1. Clone the toolkit as a sibling of agentic-harness (the canonical layout):

   cd ~/Antigravity   # or wherever you keep dev repos
   git clone https://github.com/alexherrero/agent-toolkit.git

   Skip this step if you already have agent-toolkit cloned.

2. Install everything into your target project:

   bash ~/Antigravity/agent-toolkit/install.sh /path/to/your-project

   On Windows / PowerShell:

   pwsh -NoProfile -File C:\path\to\agent-toolkit\install.ps1 C:\path\to\your-project

3. Inspect what landed:

   cd /path/to/your-project
   ls .claude/skills/ .agent/skills/
   ls -la .git/hooks/pre-push

   You should see pii-scrubber/, dependabot-fixer/, ship-release/, design/, memory/, and example-skill/ under each host's skills dir, plus an executable pre-push hook.

4. Stage and commit the installed scaffold on a branch:

   cd /path/to/your-project
   git checkout -b add-agent-toolkit
   git add .claude .agent
   git commit -m "Install agent-toolkit customizations"

   The pre-push hook is installed at .git/hooks/pre-push — git hooks aren't committed (they live outside the repo's tree), so subsequent clones of this project won't get the hook automatically. Either re-run install.sh on each clone, or add a project-level reminder.

Variants

Install only one skill

bash ~/Antigravity/agent-toolkit/install.sh --skill pii-scrubber /path/to/your-project

Install only one bundle

bash ~/Antigravity/agent-toolkit/install.sh --bundle example-bundle /path/to/your-project

Refresh an existing install (true-sync)

bash ~/Antigravity/agent-toolkit/install.sh --update /path/to/your-project

--update wipes toolkit-managed dirs (.claude/skills/, .agent/skills/) and recreates them from source. Orphan paths from previous toolkit versions get auto-cleaned. User state files (your project's wiki/, AGENTS.md, etc.) are never touched. (v0.9.0 removed .agents/skills/ from the managed-dirs set along with Gemini CLI host support — see ADR 0006.)

Skip the pre-push hook

bash ~/Antigravity/agent-toolkit/install.sh --no-pre-push-hook /path/to/your-project

Use this if the project already has a pre-push hook the toolkit shouldn't replace, or if you don't want push-time PII enforcement.

Verify

After install, confirm the structural sanity:

cd /path/to/your-project
ls .claude/skills/      # should list 6 dirs: pii-scrubber, dependabot-fixer, ship-release, design, memory, example-skill
ls .agent/skills/       # same (Antigravity)
test -x .git/hooks/pre-push && echo "hook installed"

If anything's missing, re-run with --update to force a clean recreate.

Related

• Installer CLI — full flag reference.
• Customization Types — what each installed customization is.
• Add a Skill — how to add your own.
• agent-toolkit ADR 0001 — why this repo exists.