Skip to content

Repository files navigation

Cortex

See what your coding agent actually sends — and pay less for it.

A terminal installs Cortex with one command and points Claude Code at it. Three Claude Code sessions run in separate directories, and abctl then lists all three with their token counts, cost and remaining context. Pressing $ breaks the spend down by tier, where cache reads dominate. Drilling into the busiest session shows the whole conversation and the fifteen-tool manifest it re-sends on every turn.

Cortex sits in your agent's request path, decrypts its traffic, and shows you the model calls, tool calls and agent-to-agent messages as they happen. It can also strip the tool definitions your agent never calls, which is 4–20% of the prompt on every turn.

Think top, for your coding agent. Where top shows which processes are eating your CPU, abctl observe shows which agent sessions are eating your tokens, your context window and your money — live, as they run.

One binary, no Kubernetes. macOS or Linux, amd64 or arm64.

Quick start

curl -fsSL https://raw.githubusercontent.com/rossoctl/cortex/main/authbridge/install.sh \
  | sh -s -- --claude-code

It asks before changing your Claude Code settings, then runs Cortex as a background service that survives crashes and logins.

Then open two terminals:

abctl observe   # the viewer
claude          # as usual — no environment variables to set

Your agent's calls stream into abctl. Cortex only reads them; nothing is rewritten.

Any agent works, not only Claude Code: point it at localhost:47600 and trust ~/.cortex/ca/ca.crt.

curl | sh never executes unreleased code — the script re-runs the copy from the newest release. Pin or override with --ref (CONTRIBUTING.md).

Full install guide: Cortex on your laptop — prerequisites, step-by-step walkthrough, service management and troubleshooting.

Feedback

Note

Cortex on a laptop is new, and we want to hear when it breaks.

If the install failed, the numbers looked wrong, or anything was unclear:

A half-finished install with the error pasted in is more useful to us than a polished bug report you never sent.

What else Cortex does

Traffic visibility is the part you can use in a minute. The same binary provides the platform services agentic workloads need in production, as a sidecar or standalone:

  • Identity & access — a verifiable identity per workload, and the right credentials for each downstream call, so an agent never holds a tool's secret. This layer is AuthBridge.
  • Guardrails — block agent actions that stray from the user's intent or aren't grounded in the conversation.
  • Egress control — govern which external services a workload can reach.
  • Cost controls — trim the context a workload sends, and cap its spend.

Everything is a plugin in one pipeline; the plugin catalog lists what ships, and the architecture reference explains how a request flows through it. Code lives under authbridge/.

License

Apache 2.0

About

Repository for kagenti extensions projects

Resources

Contributing

Security policy

Stars

13 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages