Skip to content

Commit 2d7fbab

Browse files
committed
docs: lpb-config runtime commands, lpb-memory origin, drift scope
- lpb-config: add show/models/set (runtime settings) + render to the reference (were missing) - lpb-memory overview: agent-facing capabilities (session search, procedural skills, secret scanning), Origin & Status section (forked from Pi Hermes Memory, refactored for local/NPU, WIP) - lpb-memory analysis: point-in-time snapshot banner - release: .pi/skills/ out of docs drift (agent-internal, not published)
1 parent 10f28d3 commit 2d7fbab

4 files changed

Lines changed: 53 additions & 3 deletions

File tree

doc/lpb-config.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,18 @@ see [lpb-devstack reference](lpb-devstack.md).
2121
| `lpb-config reset [--force]` | Re-clone config repo, destroy local changes (with confirmation) |
2222
| `lpb-config merge` | Open git merge flow for advanced users (conflict resolution) |
2323

24+
### Runtime Settings
25+
26+
| Command | Description |
27+
|---|---|
28+
| `lpb-config show [--json]` | All effective runtime settings: provider/model, thinking level, Lemonade server (reachability + model count), MCP servers, extension pins, memory config |
29+
| `lpb-config models` | List models served by the configured Lemonade server |
30+
| `lpb-config set model <id>` | Set the default model — validated against the live server's model list |
31+
| `lpb-config set thinking <level>` | Set the default thinking level (`off``max`) |
32+
| `lpb-config set base-url <url>` | Set the Lemonade server URL (API key preserved) |
33+
| `lpb-config set api-key <key>` | Set the Lemonade API key (server preserved) |
34+
| `lpb-config render [--force]` | Regenerate runtime config from the repo templates (`--force` merges: user-added keys survive, template pins win in settings.json) |
35+
2436
### Align & Pin Sync
2537

2638
| Command | Description |
@@ -119,4 +131,13 @@ lpb-config memory setup
119131
# Run / validate the initial setup
120132
lpb-config setup
121133
lpb-config check
134+
135+
# Show all effective runtime settings
136+
lpb-config show
137+
138+
# Switch model / thinking level / server
139+
lpb-config models
140+
lpb-config set model <id>
141+
lpb-config set thinking <level>
142+
lpb-config set base-url <url>
122143
```

doc/lpb-memory-analysis.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
1-
# lpb-memory Extension — Current Status
1+
# lpb-memory Extension — Status Snapshot
2+
3+
> ⚠️ **Point-in-time snapshot (2026-08-25).** A diagnostic of the live
4+
> configuration at that date — settings may have changed since. For the
5+
> current feature and configuration reference see the
6+
> [lpb-memory overview](lpb-memory-overview.md).
27
38
> **Last updated:** 2026-08-25
49
> **Status:** Active — memory writes and reads working

doc/lpb-memory-overview.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,26 @@ session model (so nothing extra to configure), or a small dedicated model
1919
| **`correct`** | On user correction | Detects user corrections to AI behavior, records as lessons |
2020
| **`consolidate`** | Periodic | Merges similar entries (reduces duplication) |
2121

22+
Agent-facing capabilities (beyond the background operations):
23+
24+
| Capability | How |
25+
|---|---|
26+
| Memory search | `memory_search` tool — full-text (SQLite FTS5) search over the memory store |
27+
| Session search | `session_search` tool — searches indexed past sessions (one-time index: `/memory-index-sessions`) |
28+
| Procedural skills | `skill_manage` tool — the agent saves *how* it solved problems, reusable across sessions (`/memory-skills` lists them) |
29+
| Secret scanning | API keys and tokens are blocked from being saved |
30+
31+
## Origin & Status
32+
33+
Forked from [Pi Hermes Memory](https://github.com/chandra447/pi-hermes-memory)
34+
and extensively refactored to work fully locally: subprocess review transport
35+
that offloads background reviews to a small local model (NPU-friendly),
36+
model/thinking overrides for the review pass, serialized review spawning with
37+
backoff, and centralized configuration under `~/.pi/agent/`. It no longer
38+
tracks upstream and is developed as part of the
39+
[LocalPibox stack](https://github.com/lpb-stack/lpb-memory)**still a work
40+
in progress**.
41+
2242
## Architecture
2343

2444
```
@@ -123,6 +143,9 @@ cat ~/.pi/agent/lpb-memory/USER.md
123143
cat ~/.pi/agent/lpb-memory/MEMORY.md
124144
cat ~/.pi/agent/lpb-memory/failures.md
125145

146+
# In Pi: index your past sessions once, then use the session_search tool
147+
/memory-index-sessions
148+
126149
# Show current configuration
127150
lpb-config memory show
128151

scripts/localpibox/stack/release.py

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -102,12 +102,13 @@ def dev_release_gate(cons: Console, *, fetch: bool = True) -> int:
102102
# Paths on dev that are code/machinery, not site content — a change there
103103
# does not invalidate a docs flag (the site never builds them). Anything
104104
# else counts as content. support/docs/ is content even though support/
105-
# holds runtime tools.
105+
# holds runtime tools. .pi/skills/ holds agent-facing skills — internal
106+
# tooling, not published on the site (kept out of the docs nav on purpose).
106107
_NON_CONTENT_FILES = frozenset({
107108
".dockerignore", ".env.example", ".gitignore", "Dockerfile", "VERSION",
108109
"lpb.conf.env", "lpb.stack.env", "lpb.stack.dev.env", "lpb.stack.main.env",
109110
})
110-
_NON_CONTENT_DIRS = ("scripts/", ".githooks/", ".github/")
111+
_NON_CONTENT_DIRS = ("scripts/", ".githooks/", ".github/", ".pi/skills/")
111112

112113

113114
def _is_content(path: str) -> bool:

0 commit comments

Comments
 (0)