Docs

# 1. Install the CLI
npm install -g @contextcontroller/cli

# 2. Create a managed session with the aggressive policy
cc session create --policy aggressive --model gpt-5

# 3. Point your client at the proxy (drop-in replacement)
export OPENAI_BASE_URL=https://proxy.contextcontroller.com/v1
export OPENAI_API_KEY=cc_live_...

# 4. Watch it work
cc watch <session-id>

from contextcontroller import Client, Priority

cc = Client(api_key="cc_live_...")

# Open a managed session with a compaction policy
session = cc.sessions.create(
    model="gpt-5",
    policy="aggressive",          # or "balanced", "conservative", custom
    target_utilization=0.6,         # compact when usage passes 60%
)

# Pin what must never be evicted
session.add("You are a senior SRE. Never reveal secrets.",
            role="system", priority=Priority.PINNED)

session.add("Debug the latency spike in checkout.",
            role="user", priority=Priority.HIGH)

# Tool outputs default to LOW priority: summarized first, evicted first
session.add(tool_result_json, role="tool")

# The SDK compacts automatically; force it any time
report = session.compact()
print(report.reclaimed_tokens)   # e.g. 50202
print(report.usage_after)      # e.g. 0.556

# Recall something that was evicted hours ago
hits = session.recall("what did the PDF say about refund policy?")
for hit in hits:
    print(hit.text, hit.source_message_id)

import { ContextController, Priority } from "@contextcontroller/sdk";

const cc = new ContextController({ apiKey: process.env.CC_API_KEY });

const session = await cc.sessions.create({
  model: "claude-opus-4-6",
  policy: "balanced",
  targetUtilization: 0.7,
});

await session.add("You are a helpful coding assistant.", {
  role: "system",
  priority: Priority.PINNED,
});

// Stream a completion through the managed session
for await (const chunk of session.stream(messages)) {
  process.stdout.write(chunk.delta);
}

const report = await session.compact();
console.log(`reclaimed ${report.reclaimedTokens} tokens`);