Skip to content
fajarhidePublic

Repository files navigation

Contexere Logo

Contexere

The context and token layer for coding agents. It shrinks noisy tool output, folds what an agent already read, and redacts credentials in the output it rewrites. Nothing is lost.

🇺🇸 English | 🇯🇵 日本語 | 🇨🇳 简体中文 | 🇸🇦 العربية | 🇮🇩 Bahasa Indonesia | 🇻🇳 Tiếng Việt | 🇰🇷 한국어

CI Release License: Apache 2.0

brew install fajarhide/tap/contexere && contexere init

Contexere distilling a noisy cargo test run down to the verdict, then contexere stats

OMNI is now Contexere, Latin for "to weave together" and the root of "context". The omni command keeps working, so existing installs need no change. Contexere is growing into one place for the skills, credentials and memory every agent uses; today it ships the context and token layer.

Why

A coding agent reads everything a command prints: progress bars, layer hashes, a file it already read ten minutes ago. Every byte is billed and takes room the agent needs for the actual work.

Contexere takes out what the model does not need, before the model reads it. Nothing is deleted: whatever it removes stays on your machine, and one command brings it back.

Features

  • Reads a file the agent already read: sends one line with a handle instead of the file again.
  • Runs a noisy build or test: keeps the result and the failures, drops the progress noise.
  • Prints a token or password in output it rewrites: replaces it with [REDACTED] before the model sees it.
  • Fails a command: passes it through as printed, so the real error reaches the agent. A credential printed by a failing command reaches the agent too.
  • Reads JSON, YAML or CSV: leaves it byte for byte.
  • contexere doctor checks that each agent's hooks fire and redact.
Without Contexere
the same 7.6 KB file, read twice
With Contexere
the second read is 214 B, 97.2% smaller
the same file read twice with no Contexere: two identical screens of source the same file read twice through Contexere: the second returns one marker line and a retrieval handle

It costs about 21 ms per command. Savings depend on what your agent does; run contexere stats for your own figure. Method and full numbers are on the benchmarks page.

Install

brew install fajarhide/tap/contexere
Where Command
macOS, Linux, WSL curl -fsSL omni.weekndlabs.com/install | bash
Windows (PowerShell) irm omni.weekndlabs.com/install.ps1 | iex

Existing installs keep working under omni, which is the same program.

Usage

contexere init      # pick your agents: Claude Code, Codex, Cursor, VS Code and more
contexere doctor    # check it is wired, or `contexere doctor --fix`
contexere stats     # what Contexere saved on your own history

contexere doctor: each agent's hooks are run with a canary credential to prove they fire and redact

After init, the hooks run on their own. There is nothing to prefix.

Supported agents

Tier Agents
Full (rewrites tool output before the model reads it) Claude Code, Codex CLI, Gemini CLI, OpenClaw, Hermes, Pi, Aider (via cmd | contexere)
Handoff-first (shortens what the agent runs through omni_run) Cursor, Windsurf
MCP-only (memory and recall, plus omni_run) Cline, Roo, OpenCode, VS Code, Zed, Copilot, Antigravity

Codex runs only hooks it trusts: after contexere init --codex, start codex once and approve them (#359).

Documentation

Contributing

Issues and pull requests are welcome. Start with CONTRIBUTING.md.

Security

Do not open a public issue. Report privately; details in SECURITY.md.

License

Apache License 2.0.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages