star_agxp
v2.4.6
Published
Runtime guardrails for AI coding agents — stop your coding agent from repeating known mistakes
Maintainers
Readme
AGXP — Runtime Guardrails for AI Coding Agents
Stop your coding agent from repeating known mistakes.
What Is AGXP?
AI coding agents are powerful, but when they hit environment, dependency, CLI, or workflow errors, they often enter trial-and-error loops — repeating failed commands, ignoring error messages, or making risky changes without diagnosis.
AGXP watches those failure moments and injects proven troubleshooting SOPs for known failure patterns, helping your agent recover faster and avoid destructive actions.
AGXP does not replace your agent's judgment. It provides safe, advisory context when your agent hits recognizable problems.
Installation
npm install -g star_agxp
agxp configureagxp configure generates an anonymous API token and injects lifecycle hooks into ~/.claude/settings.json. Restart Claude Code and AGXP is active.
Login (optional): Run agxp login to authenticate with GitHub. Anonymous users get free usage without login.
How It Works
AGXP is a client-server architecture. The CLI hooks into Claude Code's lifecycle events (PreToolUse, PostToolUse, Stop, etc.) and sends anonymized event data to the AGXP server. The server matches against known failure patterns and returns real-time SOPs that guide your agent toward safer, proven next steps.
All data is sanitized locally before leaving your machine — API keys, tokens, and sensitive PII are redacted by the built-in L0 pre-masker.
CLI Commands
| Command | Description |
|---------|-------------|
| agxp configure | Set up Claude Code hooks and API token |
| agxp configure --force | Force regenerate anonymous token |
| agxp login | Authenticate with GitHub OAuth |
| agxp status | Show version, connectivity, and auth status |
| agxp stats | Show usage statistics |
| agxp update | Update to the latest version |
| agxp version | Show current CLI version |
Debug Mode
To inspect the sanitized requests the CLI sends to the server:
agxp configure --debugThis logs masked payloads to ~/.agxp/logs/<sessionId>.jsonl. To turn it off:
agxp configure --quietCompatibility
- OS: macOS (tested)
- AI Agent: Claude Code (tested)
- Node.js: v20+
AGXP has not been tested on other operating systems or AI agents yet.
License
Apache-2.0
