STEERPLANE

Quickstart

Install SteerPlane and protect your first agent in under five minutes.

Install

pip install steerplane
npm install steerplane

Protect your first agent

Wrap your agent

Add the @guard decorator to the function that runs your agent. That's the only change.

from steerplane import guard

@guard(
    agent_name="support_bot",
    max_cost_usd=10.00,
    max_steps=50,
    denied_actions=["delete_*", "drop_*"],
)
def run_support_agent():
    agent.run()   # your code, unchanged

Run it

Run your program normally. SteerPlane intercepts every step, tracks token cost, and watches for loops and policy violations in the background.

python agent.py
🚀 SteerPlane | Run started
   Agent:  support_bot
   Limits: $10.00 cost / 50 steps
   ────────────────────────────────

See it stop a bad run

If the agent loops, exceeds its cost ceiling, or attempts a denied action, SteerPlane terminates the run and raises a structured exception:

[LOOP] Loop detected: pattern ['search_web'] repeated 4×  → run terminated
[COST] Cost ceiling $10.00 exceeded at step 38           → run terminated
[POLICY] Action 'delete_users' matches deny rule         → blocked

Prefer zero code changes? Use the gateway proxy instead — point your OpenAI client at SteerPlane and every call is governed automatically. Using Node.js? See the TypeScript SDK for the guard() and SteerPlane equivalents.

Where to next

On this page