@lolipopshock/pi-clm

Pi extension that lets the model manage its own context: the next request's context is mirrored to a file the model edits with ordinary tools

Packages

Package details

extension

Install @lolipopshock/pi-clm from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@lolipopshock/pi-clm
Package
@lolipopshock/pi-clm
Version
1.0.0
Published
Sep 30, 2026
Downloads
1,554/mo · 457/wk
Author
shannon-shen
License
MIT
Types
extension
Size
368.3 KB
Dependencies
0 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/lolipopshock/pi-clm/main/.github/images/overview.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-clm

  ____ _     __  __
 / ___| |   |  \/  |     
| |   | |   | |\/| |
| |___| |___| |  | |     
 \____|_____|_|  |_|     pi-clm — the agent that manages its own context

pi-clm is a Pi extension that lets the agent manage its own context: the language model can generate functions to modify the context (mapped as a file), and the edited version becomes its next input. Check our paper Context Language Models and research codebase.

Install

pi install npm:@lolipopshock/pi-clm

# From source, or to try it for one session without installing:
pi install git:github.com/lolipopshock/pi-clm
pi -e git:github.com/lolipopshock/pi-clm

Quick start

command what it does
/clm open the panel: overview (context size over time + compaction points) input (what the next request contains) · edits (per-revision side-by-side diff)
/clm status three lines: next request vs budget, edits, changed settings
/clm config open settings; /clm config <setting> <value> changes one, /clm config reset drops this session's changes
/clm-compact [instructions] ask the model to compact its own context now; anything you add (e.g. what to keep) is passed along. The result shows on the edits page
/clm on / off / reset enable, use raw context, discard the projection

In the panel: 1–4 or Tab switch pages, ← → step through compaction points, z zooms the chart, Enter opens the selection, q closes.

Docs

  • How it works — the mirror, what runs without the model, the panel, safety.
  • Configuration — budget, reserve, reminders, guard, steering and the other settings.
  • Architecture — the system as implemented, design notes, known limitations.
  • Development — setup, checks, releasing.

Citation

If you use pi-clm in your research, please cite Context Language Models:

@article{shao2026context,
  title   = {Context Language Models},
  author  = {Shao, Rulin and Shen, Shannon Zejiang and Yin, Junjie Oscar and Li, Yuetai and
             Wang, Minheng and Ivison, Hamish and Poovendran, Radha and Lambert, Nathan and
             Xiao, Teng and Lewis, Mike and Yih, Wen-tau and Zettlemoyer, Luke and Koh, Pang Wei},
  journal = {arXiv preprint arXiv:2609.37725},
  year    = {2026}
}