agent-gate-installer
v1.9.2
Published
One-command installer for agent-gate prompt evaluation gate
Downloads
1,766
Maintainers
Readme
agent-gate-installer
One-command setup for the agent-gate prompt evaluation gate for Claude Code.
Prerequisites
- Node.js 18+
- Python 3.11+
- git
- A GitHub personal access token with access to
jl-cmd/agent-gate
Install
GH_TOKEN=github_pat_XXXXX npx agent-gate-installerOr set GH_TOKEN in your environment first:
export GH_TOKEN=github_pat_XXXXX
npx agent-gate-installerWithout GH_TOKEN, the installer prompts interactively.
What it does
- Detects Python 3.11+ (tries
python3,python,py -3) - Clones
jl-cmd/agent-gateto~/.claude/agent-gate/ - Creates a Python venv at
~/.claude/agent-gate/.venv/ - Installs all agent-gate sub-packages in editable mode
- Merges 3 hooks into
~/.claude/settings.json(idempotent) - Registers the MCP server in
~/.claude/settings.json - Verifies the installation
Restart Claude Code after installing.
Update
npx agent-gate-installer --updatePulls the latest code and reinstalls packages.
Maintainer release notes
- Use Conventional Commit messages for releasable changes (for example
fix(installer): ...orfeat(installer): ...). - For
mainmerges, preferSquash and mergeorRebase and merge. - Avoid
Create a merge commitfor releasable changes because merge commit subjects are not conventional commits and can be skipped by release-please parsing.
Uninstall
npx agent-gate-installer --uninstallRemoves ~/.claude/agent-gate/, the hooks, and the MCP server entry from settings.json.
Flags
| Flag | Description |
|------|-------------|
| --verbose | Show detailed output from each step |
| --non-interactive | Fail if GH_TOKEN is missing (for CI/automation) |
| --update | Pull latest and reinstall packages |
| --uninstall | Remove agent-gate completely |
| --help | Show usage information |
Cloud setup script
For Claude Code on the web environments:
GH_TOKEN="${GH_TOKEN}" npx agent-gate-installer --non-interactive --verboseSet GH_TOKEN as an environment variable in your cloud environment settings.
Cross-platform
Works on Linux, macOS, and Windows. Python detection and venv paths adapt automatically.
