Skip to content

Latest commit

 

History

History
73 lines (53 loc) · 3 KB

File metadata and controls

73 lines (53 loc) · 3 KB

NeatContext for pi

Extract domain knowledge and save useful work from pi conversations as structured, reusable context that you can use in later sessions or share with others.

Part of NeatContext plugins, which also supports Claude Code, GitHub Copilot, Codex, and Kimi Code.

Why

Domain knowledge is what helps a model answer accurately for your team — your systems, constraints, decisions, terminology, and ways of working.

You build that knowledge while doing hard work with a coding agent. Long conversations about debugging, planning, incidents, and implementation already contain discoveries that will matter again. NeatContext extracts the durable knowledge from those conversations and saves it as a structured context.

Connect that context in a new session and the agent starts with the knowledge it needs instead of asking you to explain everything again.

Install

pi install npm:@xtsoftwarelabs/neatcontext-pi

Commands

Command What it does
/neatcontext-status What this session is grounded in, and its routing mode
/neatcontext-list Every context you can connect
/neatcontext-use [name] Connect a context. With no name, pick from a list
/neatcontext-disconnect Disconnect this session's context
/neatcontext-mode [auto|ask|manual] How this session may re-ground itself (--global for the default)
/neatcontext-create Create a context around a knowledge folder you already have
/neatcontext-save [name] Save this conversation's durable work as a context
/neatcontext-import <folder> Import a shared bundle, or reconcile a newer copy of one you already have
/neatcontext-export [name] --to <folder> Export a saved context as a shareable bundle
/neatcontext-delete <name> Delete a context

Each session has its own context and its own routing mode. Two pi windows can work on different contexts at once without disturbing each other.

Routing

With a context connected, the model sees a one-line description of every other context on the machine and can move the session to a better one:

  • auto (default) — it switches on a clear match and tells you it did, and asks first when two contexts are close.
  • ask — it proposes a switch and waits for you.
  • manual — it never routes; /neatcontext-use only.

Decline a switch once and it will not be suggested again in that session. When routing gets it wrong, say what you call the subject — the model records that as an alias so the same words route correctly next time.

Privacy

The plugin stores contexts under ~/.neatcontext/ on your machine. There is no NeatContext Desktop connection right now. See PRIVACY.md.

pi extensions run with full permissions. Read the source before installing — it is all in extensions/ and src/, dependency-free, and uses only Node built-ins.

License

MIT