Build governed developer-agent workflows with Contextus.

Before you begin

• 1. Create a Contextus account.
• 2. Finish guided setup and save the API key shown once.
• 3. Keep the dashboard open so you can inspect the resulting action.

Option A: Python SDK

pip install contextus

export CONTEXTUS_API_KEY="your-contextus-key"

from contextus import ContextusClient

client = ContextusClient()

result = client.compile(
    messages=[
        {"role": "user", "content": "Summarize the deployment policy for this task."}
    ],
    limit=2000,
    policy="default",
)

print(result.compiled)
print(result.original_tokens)
print(result.compiled_tokens)
print(result.reduction_percent)

Option B: MCP for Cursor or Claude Desktop

Install the Contextus MCP adapter and Cursor/Claude will automatically compile context before every LLM call.

npm install -g @contextus/mcp-adapter

Option C: VS Code extension

Install the Contextus extension from the VS Code Marketplace. Governed compile flows appear inline while you code.

Run a safe governed action

This read-only request passes through the same policy decision path used by connected agents. Your policy can allow it, request approval, redact sensitive input, or deny it.

curl https://api.contextus.coreledger.ca/tool-approvals/requests \
  --request POST \
  --header "Authorization: Bearer $CONTEXTUS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "action_name": "repository.docs.read",
    "tool_name": "quickstart",
    "action_category": "read",
    "request_source": "api",
    "args": {"path": "README.md"},
    "session_id": "contextus-quickstart"
  }'