BuildTube Preview About
Back to the feed

billion-context: Compress long coding-agent conversations

Added · Updated

Compress older coding-agent messages into searchable summaries and restore exact context later.

For developers using a supported agent with a model API.

What it does

billion-context sits between a coding agent and its model API and compresses older conversation ranges into layered summaries. The model decides when and what to compress; the tool can later search those summaries or restore a range when exact details are needed. This is aimed at long-running coding sessions where past decisions and project context need to remain available. Its documentation lists client-specific launchers or plugins for agents including Claude Code, Codex, OpenCode, pi, Gemini CLI, and others, while also describing client limitations.

How to use it

Install the npm package, follow the instructions for the coding agent you use, and point that agent through the billion-context proxy. As the conversation grows, the agent can call the supplied compress, decompress, search_context, and acp_status tools; the proxy forwards the request to the model API.

Common use cases

  • Compress a completed section of a long coding conversation and keep a summary available in the same session.
  • Search compressed context for a prior decision when the agent needs it again.
  • Restore a compressed message range when the exact earlier details matter to the next code change.

Can I use this?

Runs in a terminal · setup needed

Requirements Install with npm and follow the setup for a supported coding agent; access to that agent and its model API is still needed. The MIT license has an additional attribution term for products or services that incorporate the software: show attribution on the homepage, documentation, or About/Credits page.

Caveat Client support differs: some use native plugins and others use launchers or proxy routing. The source says the native plugin and standalone extension for the same client must not be active together. Its license also requires visible product attribution when incorporated into an end-user product or service.

Worth knowing The project routes agent requests through a local proxy; some optional client modes use certificate-based traffic handling, so follow the client-specific setup. Its MIT license adds a visible product-surface attribution requirement. Creator-reported performance figures are not independent verification.

Why it's here

  • 4,889 people have starred it on GitHub.

Numbers as of 8 November 2026, from BuildTube’s latest daily refresh.

Behind it

View setup guide

BuildTube has not run or verified this project. Everything above is written from what the creator published.

Made this?

Quick questions

What is billion-context?
billion-context sits between a coding agent and its model API and compresses older conversation ranges into layered summaries.
What can I use billion-context for?
Compress a completed section of a long coding conversation and keep a summary available in the same session; Search compressed context for a prior decision when the agent needs it again; Restore a compressed message range when the exact earlier details matter to the next code change
Can I run billion-context on my computer?
It runs from a terminal on your own computer.
What do I need to use billion-context?
Node.js/npm, a supported coding agent, and that agent’s model API. If incorporated into an end-user product or service, the license requires visible attribution.
What license does billion-context use?
Its MIT license adds a visible product-surface attribution requirement. Its license also requires visible product attribution when incorporated into an end-user product or service.

More from this week

Explore by topic

Post this

A ready-made picture of this card for X, LinkedIn or a group chat. Link to this page alongside it.

Share image for billion-contextDownload share image

For makers

Made this? Show it’s on BuildTube — add the badge to your README or embed the card on your site.

Featured on BuildTube

README badge (Markdown)

[![Featured on BuildTube](https://buildtube.app/badge/gh-ranxianglei-billion-context.svg)](https://buildtube.app/p/gh-ranxianglei-billion-context/)

Embed card (HTML)

<iframe src="https://buildtube.app/embed/gh-ranxianglei-billion-context/" width="560" height="240" style="border:0;max-width:100%" loading="lazy" title="billion-context on BuildTube"></iframe>

Back to the feed