AgentGate

Stop autonomous coding agents from burning tokens and marking broken code as done.

AgentGate is an MCP server plus Claude Code and Codex plugin packaging. It wraps agent work in explicit slices, runs real validation gates, blocks done status while gates fail, and adds Pro guardrails for multi-slice plans, token budgets, advanced gates, and analytics.

Install

Install the MCP server directly from npm in Claude Code:

claude mcp add agentgate -- npx -y @idevelopers/agentgate

Or install the Claude Code plugin from the public installer marketplace:

/plugin marketplace add https://github.com/manish-1988/agentgate-installer
/plugin install agentgate@agentgate-marketplace

For local source development from this private repository:

npm install
npm run build
node dist/index.js

Polar handles paid licenses; npm distributes the runtime package. The public installer repository contains only plugin metadata and points Claude/Codex at npx -y @idevelopers/agentgate.

Free, Pro, Team

| Capability | Free | Pro | Team | | --- | --- | --- | --- | | Single-slice run + basic gates | Yes | Yes | Yes | | Multi-slice orchestration | No | Yes | Yes | | Token-budget kill switch | No | Yes | Yes | | Advanced gates: typecheck, build, custom | No | Yes | Yes | | Run analytics export | No | Yes | Yes | | Shared policies and seats | No | No | Yes |

Pro is intended for $19/mo or $190/yr. Team is intended for $49/mo with seats. Buy Pro or Team through the live Polar checkout:

https://buy.polar.sh/polar_cl_VxlhG8lCO6IUcLcveJ51YOXYXMHWdUNorKr0U1bhyqm

Configuration

Create agentgate.config.json in your repo. Start from agentgate.config.example.json:

{
  "version": 1,
  "gates": [
    {
      "id": "test",
      "type": "test",
      "command": "npm",
      "args": ["test", "--", "--run"]
    }
  ],
  "slices": [
    {
      "id": "slice-1",
      "description": "Implement one focused change",
      "fileScope": ["src/**", "test/**"],
      "acceptance": ["Tests pass"],
      "gates": ["test"]
    }
  ]
}

For smoke tests or nonstandard filenames, point AgentGate at a specific config:

export AGENTGATE_CONFIG=agentgate.config.example.json

Tools

• agentgate_define_slice: register or update a slice in the active run.
• agentgate_run_gate: run gates for one slice.
• agentgate_run_plan: Pro multi-slice DAG execution with bounded retries.
• agentgate_budget_status: report token usage, remaining budget, estimated cost, and state.
• agentgate_activate_license: store and verify a Polar license key.

License Activation

AgentGate ships with the public Polar organization id for production license validation:

POLAR_ORGANIZATION_ID=534c0711-1ded-497c-aa46-d1a7dfa46d6e

You only need to override it when testing against a different Polar organization. For sandbox checks, set both values:

export POLAR_ENVIRONMENT=sandbox
export POLAR_ORGANIZATION_ID="your_sandbox_org_id"

Then call agentgate_activate_license with the Polar license key. AgentGate caches successful validation in ~/.agentgate/license.json and allows a 72-hour offline grace window for Pro and Team licenses. Because AgentGate license keys use Polar activation limits, activation also caches a local activation id. By default the activation label is agentgate-local; override it with AGENTGATE_ACTIVATION_LABEL if you want a more specific device label in Polar. When a user hits a paid feature without a Pro or Team license, AgentGate returns the live Polar checkout URL and tells them to activate the issued key with agentgate_activate_license.

Launch Status

Soft-launch validation was completed on 2026-06-11:

• Polar sandbox checkout issued a real sandbox license key.
• agentgate_activate_license activated that key and cached a Polar activation id.
• agentgate_run_plan passed the example Pro plan with config and typecheck slices.
• Free users can run non-Pro gates, while Pro plan execution is blocked without a valid license.
• Dogfood runs passed against AgentGate, Shipnote, PocketScan, and the mushroom tracker syntax check.
• The live Polar finance page showed account approval complete, payout account setup complete, and identity verification complete.
• A production free smoke checkout issued a live Pro license key and AgentGate activated it successfully.

Current distribution model: private source repository, public npm package, public installer marketplace, and Polar license monetization.

Security

AgentGate runs locally and does not send repo contents to an AgentGate server. It does spawn the commands listed in agentgate.config.json, using child_process.spawn with shell:false. Treat the config like a CI file: review it before running, and only run trusted gate commands.

Development

npm install
npm run build
npx vitest run

The package binary is agentgate, mapped to dist/index.js.