Agent Context Editor

Agent Context Editor is a cross-agent plugin for manually excluding and editing AI conversation context. It also supports searching, filtering, selecting, hiding, restoring, and undoing conversation changes while preserving the original Session.

中文说明: README.zh-CN.md

Features

• Manually exclude selected context and restore it later
• Edit User messages and AI Answers with restore and undo
• Search conversations and navigate between matches
• Filter User, AI, Reasoning, Answer, and Tool content
• Select individual items, continuous ranges, or multiple items
• Hide, restore, reset, and undo visual changes
• Manage AI Reasoning and final Answers independently
• Save changes without overwriting the original Session
• Automatically use a Chinese or English interface

Supported hosts

Manual context exclusion and text editing are currently available in Pi TUI and DeepSeek Harness. Editable content is limited to plain-text User messages and complete unsigned Answers.

The separate Pi Context Desktop community build provides visual conversation management for Windows x64.

Install

Pi extension

Download pi-context-editor-0.5.0.tgz from the release assets. Pi 0.84.2 installs a local package directory rather than a .tgz file. Extract the archive so that package.json is at the package directory root, then run:

pi install ./pi-context-editor-0.5.0

When working directly from this repository:

pi install ./adapters/pi-extension

For Pi Desktop registration, run adapters/pi-extension/scripts/install-desktop.ps1 with PowerShell. The script accepts -PiPath and -DesktopExePath for non-standard installations. Fully restart Pi Desktop after installation.

DeepSeek Harness

Download context-editor-deepseek-harness-0.3.0.tgz from the release assets and install it with the official Harness CLI:

dsh plugin --profile <profile> add ./context-editor-deepseek-harness-0.3.0.tgz

The adapter targets DeepSeek Harness Developer Preview commit 141eb6fef83422698aef7a981029e843e8161534 and @deepseek-ai/[email protected]. See COMPATIBILITY.md for the tested host boundary.

Usage

Pi TUI

Enter /ctx to open the full-screen Context Editor. The primary controls are x for context exclusion or restoration, e for editing, E for restoring original text, h and r for visual hiding and restoration, and s for switching the search scope. Press ? for the complete shortcut reference.

Pi Desktop/RPC

Enter /ctx to open the native Context Editor dialogs. This path supports search, filters, selection, and visual hide/restore operations. It does not currently support model-context exclusion or User/Answer editing.

DeepSeek Harness

Open the Context Editor tab beside the normal Chat view. The tab manages the same Session and provides context exclusion, User/Answer editing, search, filters, selection, visual hiding, restoration, and undo.

How it works

Agent Context Editor reads the existing Session and presents User, AI, Reasoning, Answer, and Tool content in an independent management view. Reasoning and final Answers from the same AI turn remain separately manageable, while related Tool Calls and Tool Results remain paired.

Visual changes and model-context changes are stored separately. Visual hiding only changes the Context Editor view. Confirmed context exclusion and supported text edits change the derived input sent to the model without overwriting the original Session or the host's main chat timeline.

Current limitations

• The plugin does not edit or hide content directly in the host's main chat timeline.
• Pi Desktop/RPC does not support model-context exclusion or text editing.
• Reasoning, Tool, System, attachment, structured User, and signed Answer content cannot be edited.
• Batch text replacement is not supported.
• Visual hiding does not change model input or reduce token usage.
• There is no separate hide-all operation; restore-all is available.
• AI-assisted cleanup, selected-range summaries, and summary replacement are not yet available.
• DeepSeek Harness compatibility is limited to the tested rc.8 host boundary.

Current release

The current stable project release is v0.3.0:

• Pi extension: [email protected]
• DeepSeek Harness adapter: [email protected]
• Pi Context Desktop community build: context-editor-v0.1.4

See the v0.3.0 release notes for detailed changes and verification results.

Roadmap

• Support more Agent hosts and main conversation interfaces
• Add AI-assisted Session cleanup and context suggestions
• Add reversible summary generation and replacement

Areas for future exploration

• Explore a per-prompt Conversation Context Router: before each request, evaluate how the current task relates to conversation history and assemble a minimal, dependency-safe working set. Routing would affect only the derived model input for that request, never rewrite the original Session, and remain previewable, explainable, overridable, with a full-context fallback.

Development

Requirements: Node.js 22.19 or later. Node 24 was used for the recorded local acceptance run.

npm ci
npm run verify

npm run verify builds both adapters, runs TypeScript checks and automated tests, scans the packages, and verifies the release archives.

Repository layout

agent-context-editor/
|-- adapters/
|   |-- pi-extension/          Pi /ctx adapter
|   `-- deepseek-harness/      DeepSeek Harness adapter
|-- packages/context-editor-core/
|-- docs/
|-- assets/
|-- scripts/
`-- test/

pi-app/ remains a separate Git repository and is not included in this repository.

Project status

Agent Context Editor is an independent community project. It is not affiliated with, endorsed by, or sponsored by Pi, DeepSeek, or their maintainers.

License

MIT. See LICENSE.