Integration Guides

Add human-in-the-loop oversight to your AI agents with framework-specific guides. Each guide includes prerequisites, quick start steps, and a complete runnable code example.

Recommended: Python SDK

Python SDK pip install heed

The fastest path. pip install heed, one client, submit + poll. Works with any Python agent.

Claude Code / MCP MCP

pip install heed-mcp — native request_approval tool for Claude Code, Cursor, and MCP clients.

Framework Guides

LangChain Python

Add Heed as a custom Tool in a LangChain agent. Gates actions like send_email behind human approval before execution.

OpenAI Agents SDK Python

Wrap Heed as a tool in the OpenAI Agents SDK. Submit approval requests and poll for decisions within your agent's tool loop.

Common Concepts

All guides share the same core flow:

Agent POSTs to /api/v1/hitl/requests with the intended action
If a policy gates this action → status pending, returns a poll_url
If no policy matches → status approved (auto-approve)
Decision delivered via callback webhook or polling

See the full docs for the complete API reference, or the Swagger UI for interactive exploration.