You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**A Pi extension that gives the LLM tools to manage its own context.**`spawn`, `ledger`, and `handoff` let the agent actively isolate work, persist reusable knowledge, and restart clean — without platform compaction or manual copy-paste.
8
+
**A Pi extension that gives the LLM tools to manage its own context.**`spawn`, `notebook`, and `handoff` let the agent actively isolate work, persist reusable knowledge, and restart clean — without platform compaction or manual copy-paste.
9
9
10
10
---
11
11
@@ -42,7 +42,7 @@ Then disable pi's built-in compaction so handoff stays in control:
42
42
43
43
Optional handoff resume preferences can be changed later with `/agenticoding-settings`.
44
44
45
-
That's it. Your agent now has `spawn`, `ledger_add`, `ledger_get`, `ledger_list`, `handoff`, and `/agenticoding-settings`. The status bar shows context usage and ledger count.
45
+
That's it. Your agent now has `spawn`, `notebook_write`, `notebook_read`, `notebook_index`, `handoff`, and `/agenticoding-settings`. The status bar shows context usage and notebook count.
46
46
47
47
---
48
48
@@ -51,11 +51,11 @@ That's it. Your agent now has `spawn`, `ledger_add`, `ledger_get`, `ledger_list`
51
51
| Feature | What it looks like |
52
52
|---------|-------------------|
53
53
|**Context usage %**|`ctx 65%` in status bar — green < 30%, yellow < 50%, orange < 70%, red ≥ 70% |
54
-
|**Ledger count**| 📒 `3` when entries exist, hidden when empty |
54
+
|**Notebook count**| 📒 `3` when pages exist, dim `📒 0` when empty |
55
55
|**`/handoff` command**| Instant pivot — agent drafts brief, compacts context, waits for next input (configurable auto-resume) |
56
56
|**`/agenticoding-settings` command**| TUI panel for global handoff resume behavior, with project override warnings |
57
-
|**`/ledger` command**| Overlay showing all entries with previews |
handoff("Wire OAuth routes into the middleware stack.
99
-
Ledger 'oauth-decisions' holds the constraints.")
99
+
Notebook page 'oauth-decisions' holds the constraints.")
100
100
```
101
101
102
-
The agent decided to spawn research children, save reusable findings to the ledger, delegate implementation subtasks, and handoff when context got noisy. **You said one sentence.**
102
+
The agent decided to spawn research children, save reusable findings to the notebook, delegate implementation subtasks, and handoff when context got noisy. **You said one sentence.**
103
103
104
104
---
105
105
@@ -109,13 +109,13 @@ The agent decided to spawn research children, save reusable findings to the ledg
109
109
110
110
Delegate messy work to an isolated child agent with clean context. The child inherits the parent's model and tools, works independently, and returns only the condensed result. Siblings run in parallel; the parent stays focused on orchestration. Children cannot spawn grandchildren (explosive branch prevention).
111
111
112
-
### Ledger — Continuity Across Cuts
112
+
### Notebook — Continuity Across Cuts
113
113
114
-
A sparse continuity cache the agent curates while working. After discovering something reusable — a fact, constraint, decision, or expensive finding — it saves a named entry. Later contexts fetch entries on demand instead of re-deriving the work. **The ledger persists across handoffsand existing-session restarts; starting a new session with `/new` resets it.**
114
+
A sparse pocket notebook the agent curates while working. After discovering something reusable — a fact, constraint, decision, or expensive finding — it writes a named page. Later contexts read pages on demand instead of re-deriving the work. The notebook persists across handoffs, context resets, and session restarts. Starting a new session with `/new` resets all notebook pages.
115
115
116
116
### Handoff — Deliberate Compaction
117
117
118
-
When context degrades or the job changes, the agent saves reusable state to the ledger, writes a focused brief preserving what's still missing, and restarts clean. The new context starts with the brief front-and-center, all ledger entries accessible, and zero noise.
118
+
When context degrades or the job changes, the agent saves reusable state to the notebook, writes a focused brief preserving what's still missing, and restarts clean. The new context starts with the brief front-and-center, all notebook pages accessible, and zero noise.
119
119
120
120
By default, handoff waits after compaction for your next input. To auto-resume, set `handoff.resumeBehavior` to `"proceed"`; valid values are `"wait"` and `"proceed"`.
121
121
@@ -127,7 +127,7 @@ By default, handoff waits after compaction for your next input. To auto-resume,
127
127
128
128
Run `/agenticoding-settings` to change this from the TUI. It saves global-only to `~/.pi/agent/settings.json`; project `.pi/settings.json` values still override global settings, and the panel warns when an override is active.
129
129
130
-
**Rule of thumb:** The ledger holds reusable learned knowledge. Handoff carries the remaining situational context.
130
+
**Rule of thumb:** The notebook holds reusable learned knowledge. Handoff carries the remaining situational context.
131
131
132
132
---
133
133
@@ -152,7 +152,7 @@ A single summary blob mixes durable knowledge with transient situational context
152
152
| Operation | Primitive | What It Prevents |
153
153
|-----------|-----------|-----------------|
154
154
|**Isolate**| Spawn | Context pollution from noisy subtasks |
155
-
|**Persist**|Ledger| Knowledge loss across resets and pivots |
155
+
|**Persist**|Notebook| Knowledge loss across resets and pivots |
156
156
|**Compact**| Handoff | Degradation from overstuffed context |
157
157
158
158
---
@@ -163,10 +163,10 @@ A single summary blob mixes durable knowledge with transient situational context
See [ARCHITECTURE.md](ARCHITECTURE.md) for full module breakdown, tool schemas, lifecycle wiring, spawn child-session lifecycle, and notebook rehydration algorithm.
0 commit comments