repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

prepare extensions for npm release

837dcf0c30a2361f8f9eeff9c5ab4100c4dbd535

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (117)

pi/agent/extensions/angel/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
8 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/angel/README.md

Modified
86 86 - `devil`: adversarial stress-test of an idea. User-initiated.
87 87 - `angel`: execution advisor tied to configured executor/advisor pairs, fresh max-context packet, auto-injected advice, dangerous-command gate. Suggests devil only when confidence is low and a concrete decision remains.
89 +## Demo
91 +<!-- demo:advisor_suite:start -->
92 +![Advisor suite](assets/advisor_suite.gif)
93 +<!-- demo:advisor_suite:end -->

pi/agent/extensions/angel/assets/advisor_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/angel/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-angel",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
9 8 "@earendil-works/pi-coding-agent": "*",
10 9 "@earendil-works/pi-tui": "*",
11 10 "typebox": "*"
12 - }
11 + },
12 + "license": "MIT",
13 + "description": "Structured advisor and command guardrail for Pi.",
14 + "keywords": [
15 + "pi",
16 + "pi-extension"
17 + ]

pi/agent/extensions/builtin-tools/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 0cdb8ce feat(builtin-tools): enable search tools

pi/agent/extensions/builtin-tools/README.md

Added
new file mode 100644
1 +# builtin-tools
3 +Toggle Pi builtin file-search tools.
5 +Enables or disables Pi built-in find, ls, and grep tools from inside the TUI.
7 +## Commands
9 +- `/builtin-tools`
11 +## Demo
13 +<!-- demo:tools_suite:start -->
14 +![Tools suite](assets/tools_suite.gif)
15 +<!-- demo:tools_suite:end -->

pi/agent/extensions/builtin-tools/assets/tools_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/builtin-tools/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-builtin-tools",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Toggle Pi builtin file-search tools.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/context-size/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- c1e9f71 fix(context-size): show visible usage bar
7 +- 517ba54 pi: add extension footer fallbacks
8 +- 133cb7d chore(pi): migrate extensions to earendil packages
9 +- f144b06 fix(pi): restore extension notifications
10 +- 5ca1296 Rework Pi agent extensions

pi/agent/extensions/context-size/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-context-size",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Context-window usage telemetry for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/cost/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- 517ba54 pi: add extension footer fallbacks
7 +- 133cb7d chore(pi): migrate extensions to earendil packages
8 +- 5ca1296 Rework Pi agent extensions
9 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
10 +- b408bba pi(ext): footer segment producers (context, timing, cost, runtime, git-status, pr-status, thinking)

pi/agent/extensions/cost/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-cost",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Model, token, and spend telemetry for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/ctx/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 44eb82c feat(ctx): add context indexing extension

pi/agent/extensions/ctx/README.md

Added
new file mode 100644
1 +# ctx
3 +Off-context execution and large-output search for Pi.
5 +Runs JS, Python, and shell analysis outside the main conversation and searches stored outputs.
7 +## Tools
9 +- `ctx`
11 +## Demo
13 +<!-- demo:tools_suite:start -->
14 +![Tools suite](assets/tools_suite.gif)
15 +<!-- demo:tools_suite:end -->

pi/agent/extensions/ctx/TODO.md

Added
new file mode 100644
1 +# ctx TODO
3 +- Real-LLM behavior eval: does model choose `ctx` naturally vs `bash`/`read`?
4 +- Tune thresholds/snippets after actual use.
5 +- Replace git-pinned `@marcfargas/pi-test-harness` fork once upstream PR/package exists.

pi/agent/extensions/ctx/assets/tools_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/ctx/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-ctx",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
15 14 "devDependencies": {
16 15 "@marcfargas/pi-test-harness": "git+ssh://git@github.com/bugabinga/pi-test-harness.git#0cb5ce5f10fb18c9a80e904e2e3310cc98a28e29"
17 - }
16 + },
17 + "license": "MIT",
18 + "description": "Off-context execution and large-output search for Pi.",
19 + "keywords": [
20 + "pi",
21 + "pi-extension"
22 + ]

pi/agent/extensions/cwd/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 68c7911 feat(cwd): add cwd switching command

pi/agent/extensions/cwd/README.md

Added
new file mode 100644
1 +# cwd
3 +Switch Pi cwd without leaving the session.
5 +Moves the current Pi session into another directory with /cwd.
7 +## Commands
9 +- `/cwd [path]`
11 +## Demo
13 +<!-- demo:workflow_suite:start -->
14 +![Workflow suite](assets/workflow_suite.gif)
15 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/cwd/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/cwd/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-cwd",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Switch Pi cwd without leaving the session.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/devil/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
8 +- 84b39b5 pi(ext/devil): move into dir, add README and types
9 +- 7b175ca feat(devil): comprehensive SDK integration improvements
10 +- 21fff5e fix(agent): check hasUI before setStatus
11 +- 32a29eb fix(agent): use setStatus for progress feedback
12 +- ddf7242 fix(agent): show progress widget in devil tool
13 +- b7e8de3 style(agent): apply caveman-ultra to devil prompts
14 +- 5c152c7 feat(agent): add devil - structured debate tool for reducing sycophancy

pi/agent/extensions/devil/README.md

Modified
74 74 ### Irrelevant challenges
76 76 Make `/devil <idea>` more specific. Debate context is taken from current session and recently touched files.
78 +## Demo
80 +<!-- demo:advisor_suite:start -->
81 +![Advisor suite](assets/advisor_suite.gif)
82 +<!-- demo:advisor_suite:end -->

pi/agent/extensions/devil/assets/advisor_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/devil/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-devil",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
17 16 "devDependencies": {
18 17 "@marcfargas/pi-test-harness": "git+ssh://git@github.com/bugabinga/pi-test-harness.git#0cb5ce5f10fb18c9a80e904e2e3310cc98a28e29"
19 - }
18 + },
19 + "license": "MIT",
20 + "description": "Devil's advocate debate command for Pi.",
21 + "keywords": [
22 + "pi",
23 + "pi-extension"
24 + ]

pi/agent/extensions/diff-review/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 890ddec fix(diff-review): remove trailing blank line
7 +- 115fb9d rework diff-review browser session
8 +- 28145f0 feat(diff-review): keep browser review live
9 +- 81627eb fix(diff-review): use content hashes for bundle freshness
10 +- ebc114c feat(diff-review): add browser review UI
11 +- 9702d68 remove unused pi extensions
12 +- aeef091 Update diff tools and terminal fonts

pi/agent/extensions/diff-review/README.md

Added
new file mode 100644
1 +# diff-review
3 +Browser-based git diff review bridge for Pi.
5 +Opens a local browser UI for reviewing diffs and sending findings back to Pi.
7 +## Commands
9 +- `/diff-review`
10 +- `/diff-review-cancel`
12 +## Demo
14 +<!-- demo:workflow_suite:start -->
15 +![Workflow suite](assets/workflow_suite.gif)
16 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/diff-review/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/diff-review/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-diff-review",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
16 15 "peerDependencies": {
17 16 "@earendil-works/pi-coding-agent": "*"
18 - }
17 + },
18 + "license": "MIT",
19 + "description": "Browser-based git diff review bridge for Pi.",
20 + "keywords": [
21 + "pi",
22 + "pi-extension"
23 + ]

pi/agent/extensions/footer/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- 517ba54 pi: add extension footer fallbacks
7 +- 133cb7d chore(pi): migrate extensions to earendil packages
8 +- f144b06 fix(pi): restore extension notifications
9 +- 5ca1296 Rework Pi agent extensions
10 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
11 +- b18f0e2 refactor(pi/footer): clean sweep — kill dead code, extract helpers, name constants, type properly
12 +- 972978f fix(pi/footer): force full redraw (requestRender(true)) to clear old footer on hide
13 +- 0ea30fd fix(pi/footer): force render after swap to immediately clear old lines
14 +- a49441f fix(pi/footer): swap footer via setFooter() on toggle for true 0-height when hidden
15 +- 1cfa6a1 fix(pi/footer): import Key from pi-tui, not pi-coding-agent
16 +- 933bcb6 pi(ext/footer): semantic zones, flow layout, 4-line stable height, /footer toggle

pi/agent/extensions/footer/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-footer",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-tui": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "Shared stable footer renderer for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/ghost/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- db7b1c5 Update agent and terminal configs
7 +- 5ca1296 Rework Pi agent extensions
8 +- b045a6b fix(pi/mux): cooldown exhausted keys on provider usage-limit errors
9 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
10 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/ghost/README.md

Added
new file mode 100644
1 +# ghost
3 +Background ghost agent helper for Pi.
5 +Runs a secondary Pi agent session for background analysis and coordination.
7 +## Demo
9 +<!-- demo:advisor_suite:start -->
10 +![Advisor suite](assets/advisor_suite.gif)
11 +<!-- demo:advisor_suite:end -->

pi/agent/extensions/ghost/assets/advisor_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/ghost/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-ghost",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-ai": "*",
9 8 "@earendil-works/pi-coding-agent": "*",
10 9 "@earendil-works/pi-tui": "*"
11 - }
10 + },
11 + "license": "MIT",
12 + "description": "Background ghost agent helper for Pi.",
13 + "keywords": [
14 + "pi",
15 + "pi-extension"
16 + ]

pi/agent/extensions/git-safe/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b045a6b fix(pi/mux): cooldown exhausted keys on provider usage-limit errors
8 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
9 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/git-safe/README.md

Added
new file mode 100644
1 +# git-safe
3 +Hardened git clone tool for Pi.
5 +Provides git_clone_safe with hook, symlink, LFS, and disk-exhaustion protections.
7 +## Tools
9 +- `git_clone_safe`
11 +## Demo
13 +<!-- demo:tools_suite:start -->
14 +![Tools suite](assets/tools_suite.gif)
15 +<!-- demo:tools_suite:end -->

pi/agent/extensions/git-safe/assets/tools_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/git-safe/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-git-safe",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-tui": "*",
10 9 "typebox": "*"
11 - }
10 + },
11 + "license": "MIT",
12 + "description": "Hardened git clone tool for Pi.",
13 + "keywords": [
14 + "pi",
15 + "pi-extension"
16 + ]

pi/agent/extensions/git-status/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- 517ba54 pi: add extension footer fallbacks
7 +- 133cb7d chore(pi): migrate extensions to earendil packages
8 +- 5ca1296 Rework Pi agent extensions
9 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
10 +- b408bba pi(ext): footer segment producers (context, timing, cost, runtime, git-status, pr-status, thinking)

pi/agent/extensions/git-status/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-git-status",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Git workspace telemetry for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/inline/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages

pi/agent/extensions/inline/README.md

Added
new file mode 100644
1 +# inline
3 +Inline shell expansion for Pi prompts.
5 +Expands !{...} snippets before prompts reach the model.
7 +## Demo
9 +<!-- demo:shell_suite:start -->
10 +![Shell suite](assets/shell_suite.gif)
11 +<!-- demo:shell_suite:end -->

pi/agent/extensions/inline/assets/shell_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/inline/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-inline",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Inline shell expansion for Pi prompts.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/llmiterate/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions

pi/agent/extensions/llmiterate/README.md

Modified
152 152 /llmiterate reset forget processed marker ledger
153 153 /llmiterate reload reload config + watcher
156 +## Demo
158 +<!-- demo:workflow_suite:start -->
159 +![Workflow suite](assets/workflow_suite.gif)
160 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/llmiterate/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/llmiterate/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-llmiterate",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
10 9 "peerDependencies": {
11 10 "@earendil-works/pi-coding-agent": "*",
12 11 "@earendil-works/pi-tui": "*"
13 - }
12 + },
13 + "license": "MIT",
14 + "description": "LLM iteration watcher for Pi.",
15 + "keywords": [
16 + "pi",
17 + "pi-extension"
18 + ]

pi/agent/extensions/lucifiber/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- d75170a add lucifiber theme package

pi/agent/extensions/lucifiber/README.md

Modified
58 58 - `@bugabinga/pi-ext-terse` — inject terse response protocol into the system prompt.
59 59 - `@bugabinga/pi-ext-usage` — local usage statistics dashboard across sessions.
60 60 - `@bugabinga/pi-ext-web` — web fetch/search and image-understanding tools.
62 +## Demo
64 +<!-- demo:lucifiber_suite:start -->
65 +![Lucifiber bundle](assets/lucifiber_suite.gif)
66 +<!-- demo:lucifiber_suite:end -->

pi/agent/extensions/lucifiber/assets/lucifiber_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/lucifiber/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-lucifiber",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 - "keywords": ["pi-package"],
6 + "keywords": [
7 + "pi-package",
8 + "pi"
9 + ],
8 10 "peerDependencies": {
9 11 "@earendil-works/pi-coding-agent": "*"
11 13 "pi": {
12 - "extensions": ["./index.ts"],
13 - "skills": ["./skills"],
14 - "prompts": ["./prompts"],
15 - "themes": ["./themes"]
16 - }
14 + "extensions": [
15 + "./index.ts"
16 + ],
17 + "skills": [
18 + "./skills"
19 + ],
20 + "prompts": [
21 + "./prompts"
22 + ],
23 + "themes": [
24 + "./themes"
25 + ]
26 + },
27 + "license": "MIT",
28 + "description": "Lucifiber Pi package bundle."

pi/agent/extensions/neko/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b045a6b fix(pi/mux): cooldown exhausted keys on provider usage-limit errors
8 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages

pi/agent/extensions/neko/README.md

Added
new file mode 100644
1 +# neko
3 +Tiny animated editor cat for Pi.
5 +Adds a terminal cat companion reacting to agent and tool activity.
7 +## Commands
9 +- `/neko [on|off|toggle|status]`
11 +## Demo
13 +<!-- demo:advisor_suite:start -->
14 +![Advisor suite](assets/advisor_suite.gif)
15 +<!-- demo:advisor_suite:end -->

pi/agent/extensions/neko/assets/advisor_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/neko/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-neko",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
10 9 "peerDependencies": {
11 10 "@earendil-works/pi-coding-agent": "*",
12 11 "@earendil-works/pi-tui": "*"
13 - }
12 + },
13 + "license": "MIT",
14 + "description": "Tiny animated editor cat for Pi.",
15 + "keywords": [
16 + "pi",
17 + "pi-extension"
18 + ]

pi/agent/extensions/nu-bang/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 3b453ee feat(pi): add nushell bang extension

pi/agent/extensions/nu-bang/README.md

Added
new file mode 100644
1 +# nu-bang
3 +Nushell bang-command bridge for Pi.
5 +Runs Pi ! and !! shell input through Nushell with completions.
7 +## Demo
9 +<!-- demo:shell_suite:start -->
10 +![Shell suite](assets/shell_suite.gif)
11 +<!-- demo:shell_suite:end -->

pi/agent/extensions/nu-bang/assets/shell_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/nu-bang/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-nu-bang",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
10 9 "peerDependencies": {
11 10 "@earendil-works/pi-coding-agent": "*",
12 11 "@earendil-works/pi-tui": "*"
13 - }
12 + },
13 + "license": "MIT",
14 + "description": "Nushell bang-command bridge for Pi.",
15 + "keywords": [
16 + "pi",
17 + "pi-extension"
18 + ]

pi/agent/extensions/prompt-autopsy/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions

pi/agent/extensions/prompt-autopsy/README.md

Added
new file mode 100644
1 +# prompt-autopsy
3 +System-prompt autopsy command for Pi.
5 +Writes the live generated system prompt into VISUAL for inspection.
7 +## Commands
9 +- `/prompt-autopsy`
11 +## Demo
13 +<!-- demo:workflow_suite:start -->
14 +![Workflow suite](assets/workflow_suite.gif)
15 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/prompt-autopsy/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/prompt-autopsy/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-prompt-autopsy",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-tui": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "System-prompt autopsy command for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/prune/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/prune/README.md

Modified
71 71 - `bun test` intentionally excludes `__tests__/real/` → no skipped real test in normal runs.
72 72 - `test:real` uses only MiniMax, temp cwd/agentDir/session, `noExtensions: true`, only prune loaded.
74 +## Demo
76 +<!-- demo:prune_suite:start -->
77 +![Prune recall](assets/prune_suite.gif)
78 +<!-- demo:prune_suite:end -->

pi/agent/extensions/prune/assets/prune_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/prune/package.json

Modified
3 3 "name": "@bugabinga/pi-ext-prune",
4 4 "version": "0.1.0",
5 5 "description": "Lossless conversation compactor for pi",
6 - "private": true,
7 6 "type": "module",
8 7 "main": "index.ts",
9 8 "scripts": {
18 17 "pi",
19 18 "extension",
20 19 "compaction",
21 - "memory"
20 + "memory",
21 + "pi-extension"
23 23 "license": "MIT",
24 24 "peerDependencies": {

pi/agent/extensions/pulse/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b045a6b fix(pi/mux): cooldown exhausted keys on provider usage-limit errors
8 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages

pi/agent/extensions/pulse/README.md

Added
new file mode 100644
1 +# pulse
3 +Living documentation sync for Pi.
5 +Tracks docs and queues updates when project files change.
7 +## Commands
9 +- `/pulse help`
11 +## Demo
13 +<!-- demo:workflow_suite:start -->
14 +![Workflow suite](assets/workflow_suite.gif)
15 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/pulse/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/pulse/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-pulse",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-ai": "*",
9 8 "@earendil-works/pi-coding-agent": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "Living documentation sync for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/q/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- e01763d feat(q): add question answer wizard

pi/agent/extensions/q/README.md

Added
new file mode 100644
1 +# q
3 +Follow-up question fork helper for Pi.
5 +Discusses answer choices in a fork and returns the selected answer.
7 +## Commands
9 +- `/q`
10 +- `/b`
12 +## Demo
14 +<!-- demo:workflow_suite:start -->
15 +![Workflow suite](assets/workflow_suite.gif)
16 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/q/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/q/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-q",
3 - "version": "0.0.0",
4 - "private": true,
3 + "version": "0.1.0",
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-ai": "*",
10 9 "@earendil-works/pi-tui": "*"
11 - }
10 + },
11 + "license": "MIT",
12 + "description": "Follow-up question fork helper for Pi.",
13 + "keywords": [
14 + "pi",
15 + "pi-extension"
16 + ]

pi/agent/extensions/quota/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- 517ba54 pi: add extension footer fallbacks
7 +- b924295 config: add kimi coding model
8 +- 5ca1296 Rework Pi agent extensions
9 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages

pi/agent/extensions/quota/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-quota",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Subscription quota dashboard for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/runtime/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 6a97080 add asciinema demo workflow
6 +- 517ba54 pi: add extension footer fallbacks
7 +- 133cb7d chore(pi): migrate extensions to earendil packages
8 +- 5ca1296 Rework Pi agent extensions
9 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
10 +- 0bf9702 pi(ext/runtime): update runtime extension
11 +- b408bba pi(ext): footer segment producers (context, timing, cost, runtime, git-status, pr-status, thinking)

pi/agent/extensions/runtime/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-runtime",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Runtime detection telemetry for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/session-rename/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
8 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/session-rename/README.md

Added
new file mode 100644
1 +# session-rename
3 +Automatic short session names for Pi.
5 +Generates and refines concise session names while respecting manual names.
7 +## Commands
9 +- `/session-rename [name]`
11 +## Demo
13 +<!-- demo:workflow_suite:start -->
14 +![Workflow suite](assets/workflow_suite.gif)
15 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/session-rename/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/session-rename/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-session-rename",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-ai": "*",
9 8 "@earendil-works/pi-coding-agent": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "Automatic short session names for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/ssh-tools/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions

pi/agent/extensions/ssh-tools/README.md

Added
new file mode 100644
1 +# ssh-tools
3 +SSH mode and remote tools for Pi.
5 +Toggles remote SSH targets and exposes remote shell/file tools.
7 +## Commands
9 +- `/ssh [status|off|host[:path]]`
11 +## Tools
13 +- `ssh_bash`
15 +## Demo
17 +<!-- demo:shell_suite:start -->
18 +![Shell suite](assets/shell_suite.gif)
19 +<!-- demo:shell_suite:end -->

pi/agent/extensions/ssh-tools/assets/shell_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/ssh-tools/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-ssh-tools",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-tui": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "SSH mode and remote tools for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/terminal-notifier/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- f144b06 fix(pi): restore extension notifications

pi/agent/extensions/terminal-notifier/README.md

Added
new file mode 100644
1 +# terminal-notifier
3 +Terminal notification bridge for Pi.
5 +Sends terminal/native notifications when Pi finishes work.
7 +## Demo
9 +<!-- demo:shell_suite:start -->
10 +![Shell suite](assets/shell_suite.gif)
11 +<!-- demo:shell_suite:end -->

pi/agent/extensions/terminal-notifier/assets/shell_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/terminal-notifier/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-terminal-notifier",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Terminal notification bridge for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/terminal-signals/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- cfce680 improve wezterm workspace and pi status
6 +- e280d5a fix(pi): reset terminal signals on session start
7 +- 5ca1296 Rework Pi agent extensions
8 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages

pi/agent/extensions/terminal-signals/README.md

Added
new file mode 100644
1 +# terminal-signals
3 +Terminal lifecycle signals for Pi.
5 +Emits standard terminal escape sequences for agent busy/idle state.
7 +## Demo
9 +<!-- demo:shell_suite:start -->
10 +![Shell suite](assets/shell_suite.gif)
11 +<!-- demo:shell_suite:end -->

pi/agent/extensions/terminal-signals/assets/shell_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/terminal-signals/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-terminal-signals",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Terminal lifecycle signals for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/terse/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions

pi/agent/extensions/terse/README.md

Added
new file mode 100644
1 +# terse
3 +Terse response protocol injector for Pi.
5 +Injects a compact no-fluff response protocol into agent prompts.
7 +## Demo
9 +<!-- demo:advisor_suite:start -->
10 +![Advisor suite](assets/advisor_suite.gif)
11 +<!-- demo:advisor_suite:end -->

pi/agent/extensions/terse/assets/advisor_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/terse/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-terse",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*"
9 - }
8 + },
9 + "license": "MIT",
10 + "description": "Terse response protocol injector for Pi.",
11 + "keywords": [
12 + "pi",
13 + "pi-extension"
14 + ]

pi/agent/extensions/usage/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 5ca1296 Rework Pi agent extensions
7 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
8 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/usage/README.md

Added
new file mode 100644
1 +# usage
3 +Local usage statistics dashboard for Pi.
5 +Aggregates token and cost stats from local Pi session JSONL files.
7 +## Commands
9 +- `/usage`
11 +## Demo
13 +<!-- demo:workflow_suite:start -->
14 +![Workflow suite](assets/workflow_suite.gif)
15 +<!-- demo:workflow_suite:end -->

pi/agent/extensions/usage/assets/workflow_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/usage/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-usage",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "peerDependencies": {
8 7 "@earendil-works/pi-coding-agent": "*",
9 8 "@earendil-works/pi-tui": "*"
10 - }
9 + },
10 + "license": "MIT",
11 + "description": "Local usage statistics dashboard for Pi.",
12 + "keywords": [
13 + "pi",
14 + "pi-extension"
15 + ]

pi/agent/extensions/web/CHANGELOG.md

Added
new file mode 100644
1 +# Changelog
3 +## 0.1.0 - 2026-05-21
5 +- 133cb7d chore(pi): migrate extensions to earendil packages
6 +- 2161a15 fix(web): use Z.AI MCP search
7 +- db7b1c5 Update agent and terminal configs
8 +- 5ca1296 Rework Pi agent extensions
9 +- 2157199 test(pi): add mux harness and MiniMax/web tool tests
10 +- b045a6b fix(pi/mux): cooldown exhausted keys on provider usage-limit errors
11 +- b87a61a feat(pi): monorepo workspace — all extensions are proper packages
12 +- 5fbf178 pi(ext): add remaining extensions (angel, animations, code-actions, files-widget, ghost, git-safe, neko, prune, web, etc.)

pi/agent/extensions/web/README.md

Added
new file mode 100644
1 +# web
3 +Web fetch, search, and image tools for Pi.
5 +Adds web_fetch, web_search, and understand_image tools.
7 +## Tools
9 +- `web_fetch`
10 +- `web_search`
11 +- `understand_image`
13 +## Demo
15 +<!-- demo:tools_suite:start -->
16 +![Tools suite](assets/tools_suite.gif)
17 +<!-- demo:tools_suite:end -->

pi/agent/extensions/web/assets/tools_suite.gif

Added
new file mode 100644

Current version contains binary or non-UTF-8 data.

pi/agent/extensions/web/package.json

Modified
2 2 "name": "@bugabinga/pi-ext-web",
3 3 "version": "0.1.0",
4 - "private": true,
5 4 "type": "module",
6 5 "main": "index.ts",
7 6 "scripts": {
17 16 "devDependencies": {
18 17 "@marcfargas/pi-test-harness": "git+ssh://git@github.com/bugabinga/pi-test-harness.git#0cb5ce5f10fb18c9a80e904e2e3310cc98a28e29"
19 - }
18 + },
19 + "license": "MIT",
20 + "description": "Web fetch, search, and image tools for Pi.",
21 + "keywords": [
22 + "pi",
23 + "pi-extension"
24 + ]

pi/drivers/advisor_suite.py

Added
new file mode 100644
1 +title = "Advisor suite"
3 +extensions = [
4 + "angel",
5 + "devil",
6 + "ghost",
7 + "neko",
8 + "terse",
9 +]
11 +targets = [
12 + "angel",
13 + "devil",
14 + "ghost",
15 + "neko",
16 + "terse",
19 +cols = 100
20 +rows = 28
21 +cwd = "agent/extensions/lucifiber"
23 +steps = [
24 + ("wait", 5000),
25 + ("command", "/neko status", 3000),
26 + ("command", "/neko on", 4000),
27 + ("command", "/angel-policy", 3000),
28 + ("command", "/devil Publish every extension to npm today, no review needed.", 18000),
29 + ("prompt", "Give a terse safety review of publishing many npm packages at once.", 16000),
30 + ("wait", 6000),

pi/drivers/lucifiber_suite.py

Added
new file mode 100644
1 +title = "Lucifiber bundle"
3 +extensions = [
4 + "lucifiber",
5 + "footer",
6 + "context-size",
7 + "cost",
8 + "git-status",
9 + "runtime",
10 + "quota",
13 +targets = [
14 + "lucifiber",
17 +cols = 100
18 +rows = 28
19 +cwd = "agent/extensions/lucifiber"
21 +steps = [
22 + ("wait", 5000),
23 + ("command", "/quota", 6000),
24 + ("prompt", "In one terse sentence, describe the Lucifiber Pi bundle in this directory.", 16000),
25 + ("command", "/footer", 4000),
26 + ("command", "/footer", 6000),
27 + ("wait", 6000),

pi/drivers/prune_suite.py

Added
new file mode 100644
1 +title = "Prune recall"
3 +extensions = [
4 + "prune",
5 +]
7 +targets = [
8 + "prune",
9 +]
11 +cols = 100
12 +rows = 28
13 +cwd = "agent/extensions/prune"
15 +steps = [
16 + ("wait", 5000),
17 + ("prompt", "Remember this phrase for the demo: lossless compaction keeps recall searchable.", 12000),
18 + ("command", "/prune-recall compaction all", 5000),
19 + ("command", "/prune demo focus", 8000),
20 + ("wait", 6000),

pi/drivers/shell_suite.py

Added
new file mode 100644
1 +title = "Shell suite"
3 +extensions = [
4 + "inline",
5 + "nu-bang",
6 + "ssh-tools",
7 + "terminal-notifier",
8 + "terminal-signals",
9 +]
11 +targets = [
12 + "inline",
13 + "nu-bang",
14 + "ssh-tools",
15 + "terminal-notifier",
16 + "terminal-signals",
19 +cols = 100
20 +rows = 28
21 +cwd = "agent/extensions/lucifiber"
23 +steps = [
24 + ("wait", 5000),
25 + ("command", "/ssh status", 3000),
26 + ("prompt", "Explain what this inline shell value means: !{printf lucifiber-demo}", 14000),
27 + ("command", "!date now | format date '%Y-%m-%d'", 5000),
28 + ("prompt", "Answer with exactly three words: terminal signals ready.", 12000),
29 + ("wait", 6000),

pi/drivers/tools_suite.py

Added
new file mode 100644
1 +title = "Tools suite"
3 +extensions = [
4 + "builtin-tools",
5 + "ctx",
6 + "git-safe",
7 + "web",
8 +]
10 +targets = [
11 + "builtin-tools",
12 + "ctx",
13 + "git-safe",
14 + "web",
17 +cols = 100
18 +rows = 28
19 +cwd = "agent/extensions/lucifiber"
21 +steps = [
22 + ("wait", 5000),
23 + ("command", "/builtin-tools", 4000),
24 + ("prompt", "Use web_fetch to fetch https://example.com and summarize the page in one sentence.", 16000),
25 + ("prompt", "Use ctx to run a tiny Python count of files in this directory.", 14000),
26 + ("prompt", "Call git_clone_safe for https://github.com/octocat/Hello-World into /tmp/pi-demo-hello-world, then report success briefly.", 18000),
27 + ("wait", 6000),

pi/drivers/workflow_suite.py

Added
new file mode 100644
1 +title = "Workflow suite"
3 +extensions = [
4 + "cwd",
5 + "diff-review",
6 + "llmiterate",
7 + "pulse",
8 + "q",
9 + "session-rename",
10 + "prompt-autopsy",
11 + "usage",
14 +targets = [
15 + "cwd",
16 + "diff-review",
17 + "llmiterate",
18 + "pulse",
19 + "q",
20 + "session-rename",
21 + "prompt-autopsy",
22 + "usage",
25 +cols = 100
26 +rows = 28
27 +cwd = "agent/extensions/lucifiber"
29 +steps = [
30 + ("wait", 5000),
31 + ("command", "/session-rename release demo", 3000),
32 + ("command", "/cwd", 3000),
33 + ("command", "/llmiterate status", 4000),
34 + ("command", "/pulse help", 6000),
35 + ("prompt", "Ask me two crisp follow-up questions about npm release automation.", 14000),
36 + ("command", "/q", 6000),
37 + ("command", "/diff-review-cancel", 3000),
38 + ("command", "/usage", 7000),
39 + ("send", "q", 1000),
40 + ("wait", 5000),

pi/justfile

Modified
4 4 _default:
5 5 python3 scripts/extensions.py list
7 7 check ext="":
8 8 python3 scripts/extensions.py check {{ ext }}
10 +publish ext="":
11 + python3 scripts/extensions.py publish {{ ext }}
10 13 demo name:
11 14 python3 scripts/demo.py {{ name }}

pi/scripts/extensions.py

Modified
4 4 #!/usr/bin/env python3
5 5 """Pi extension package workflow."""
7 7 from __future__ import annotations
9 9 import argparse
10 +import datetime as dt
10 11 import json
11 12 import re
12 13 import shutil
24 25 IMPORT_RE = re.compile(r"(?:import|export)\s+(?:[^'\"]+?\s+from\s+)?['\"]([^'\"]+)['\"]|import\(['\"]([^'\"]+)['\"]\)")
25 26 SECRET_RE = re.compile(r"(api[_-]?key|secret|token|password)\s*[:=]\s*['\"][^'\"]{12,}", re.I)
27 +SEMVER_RE = re.compile(r"^(\d+)\.(\d+)\.(\d+)$")
28 30 def pkg_name(spec: str) -> str:
36 38 return json.loads((ext / "package.json").read_text())
41 +def write_pkg(ext: Path, pkg: dict) -> None:
42 + (ext / "package.json").write_text(json.dumps(pkg, indent=2, ensure_ascii=False) + "\n")
39 45 def ext_dirs(selected: list[str]) -> list[Path]:
40 46 dirs = sorted(p.parent for p in EXT_ROOT.glob("*/package.json"))
41 47 if not selected:
174 180 print(f"OK pack {ext.name} ({len(info.get('files', []))} files, {info.get('unpackedSize', 0)} bytes unpacked)")
183 +def npm_whoami() -> bool:
184 + proc = subprocess.run(
185 + ["npm", "whoami"],
186 + text=True,
187 + stdout=subprocess.PIPE,
188 + stderr=subprocess.PIPE,
190 + if proc.returncode != 0:
191 + print("ERROR npm auth missing; run npm login", file=sys.stderr)
192 + if proc.stderr:
193 + print(proc.stderr, file=sys.stderr)
194 + return False
195 + print(f"OK npm auth {proc.stdout.strip()}")
196 + return True
199 +def npm_latest_version(package: str) -> str | None:
200 + proc = subprocess.run(
201 + ["npm", "view", package, "version", "--json"],
202 + text=True,
203 + stdout=subprocess.PIPE,
204 + stderr=subprocess.PIPE,
206 + if proc.returncode == 0:
207 + return json.loads(proc.stdout)
208 + if "E404" in proc.stderr or "404 Not Found" in proc.stderr:
209 + return None
210 + raise subprocess.CalledProcessError(proc.returncode, proc.args, proc.stdout, proc.stderr)
213 +def parse_semver(version: str) -> tuple[int, int, int]:
214 + match = SEMVER_RE.match(version)
215 + if not match:
216 + raise SystemExit(f"unsupported version (expected x.y.z): {version}")
217 + return tuple(int(part) for part in match.groups())
220 +def format_semver(version: tuple[int, int, int]) -> str:
221 + return ".".join(str(part) for part in version)
224 +def bump_semver(version: str, kind: str) -> str:
225 + major, minor, patch = parse_semver(version)
226 + if kind == "major":
227 + return f"{major + 1}.0.0"
228 + if kind == "minor":
229 + return f"{major}.{minor + 1}.0"
230 + if kind == "patch":
231 + return f"{major}.{minor}.{patch + 1}"
232 + raise AssertionError(kind)
235 +def npm_publish(ext: Path, otp: str | None) -> None:
236 + cmd = ["npm", "publish", "--access", "public"]
237 + if otp:
238 + cmd.extend(["--otp", otp])
239 + subprocess.run(cmd, cwd=ext, check=True)
242 +def git_tag_exists(tag: str) -> bool:
243 + return subprocess.run(
244 + ["git", "rev-parse", "--verify", "--quiet", f"refs/tags/{tag}"],
245 + cwd=ROOT,
246 + stdout=subprocess.DEVNULL,
247 + stderr=subprocess.DEVNULL,
248 + ).returncode == 0
251 +def git_tag_release(pkg_name: str, version: str) -> None:
252 + tag = f"{pkg_name}@{version}"
253 + if git_tag_exists(tag):
254 + print(f"OK tag {tag} exists")
255 + return
256 + subprocess.run(["git", "tag", tag], cwd=ROOT, check=True)
257 + print(f"OK tag {tag}")
177 260 def cmd_list(selected: list[str]) -> int:
178 261 for ext in ext_dirs(selected):
179 262 print(f"{ext.name}\t{read_pkg(ext).get('name')}")
180 263 return 0
266 +def git_changes(ext: Path, since: str | None) -> list[str]:
267 + cmd = ["git", "log", "--format=%h %s"]
268 + if since:
269 + cmd.append(f"{since}..HEAD")
270 + cmd.extend(["--", str(ext.relative_to(ROOT))])
271 + proc = subprocess.run(cmd, cwd=ROOT, text=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
272 + return [line.strip() for line in proc.stdout.splitlines() if line.strip()]
275 +def latest_release_tag(pkg_name: str, latest: str | None) -> str | None:
276 + if not latest:
277 + return None
278 + tag = f"{pkg_name}@{latest}"
279 + proc = subprocess.run(["git", "rev-parse", "--verify", "--quiet", f"refs/tags/{tag}"], cwd=ROOT)
280 + return tag if proc.returncode == 0 else None
283 +def changelog_entry(ext: Path, pkg: dict, version: str, latest: str | None) -> str:
284 + today = dt.date.today().isoformat()
285 + tag = latest_release_tag(pkg["name"], latest)
286 + changes = git_changes(ext, tag)
287 + bullets = changes or ["Initial npm release."]
288 + body = "\n".join(f"- {line}" for line in bullets)
289 + return f"## {version} - {today}\n\n{body}\n"
292 +def update_changelog(ext: Path, pkg: dict, version: str, latest: str | None) -> None:
293 + path = ext / "CHANGELOG.md"
294 + entry = changelog_entry(ext, pkg, version, latest)
295 + heading = f"## {version} - "
296 + if not path.exists():
297 + path.write_text(f"# Changelog\n\n{entry}")
298 + return
300 + text = path.read_text()
301 + if heading in text:
302 + lines = text.splitlines(keepends=True)
303 + start = next(i for i, line in enumerate(lines) if line.startswith(heading))
304 + end = next((i for i in range(start + 1, len(lines)) if lines[i].startswith("## ")), len(lines))
305 + path.write_text("".join(lines[:start]) + entry + "\n" + "".join(lines[end:]).lstrip("\n"))
306 + return
308 + if text.startswith("# Changelog"):
309 + _, rest = text.split("\n", 1)
310 + path.write_text("# Changelog\n\n" + entry + "\n" + rest.lstrip("\n"))
311 + else:
312 + path.write_text(f"# Changelog\n\n{entry}\n{text}")
315 +def prepare_release(ext: Path, bump: str) -> None:
316 + pkg = read_pkg(ext)
317 + name = pkg["name"]
318 + current = pkg.get("version", "0.0.0")
319 + latest = npm_latest_version(name)
321 + if current == "0.0.0":
322 + current = "0.1.0"
324 + version = current
325 + if latest and parse_semver(version) <= parse_semver(latest):
326 + version = bump_semver(latest, bump)
328 + if pkg.get("version") != version:
329 + pkg["version"] = version
330 + write_pkg(ext, pkg)
331 + print(f"OK version {name} {current} -> {version}")
332 + else:
333 + print(f"OK version {name} {version}")
335 + update_changelog(ext, pkg, version, latest)
336 + print(f"OK changelog {ext.name}/CHANGELOG.md")
183 339 def cmd_check(selected: list[str]) -> int:
184 340 dirs = ext_dirs(selected)
185 341 errors: list[str] = []
227 383 return 0
386 +def cmd_publish(selected: list[str], otp: str | None, bump: str) -> int:
387 + dirs = ext_dirs(selected)
388 + if not npm_whoami():
389 + return 1
391 + try:
392 + for ext in dirs:
393 + prepare_release(ext, bump)
394 + except subprocess.CalledProcessError as e:
395 + print("ERROR release prep", file=sys.stderr)
396 + if e.stdout:
397 + print(e.stdout, file=sys.stderr)
398 + if e.stderr:
399 + print(e.stderr, file=sys.stderr)
400 + return e.returncode or 1
402 + checked = cmd_check(selected)
403 + if checked != 0:
404 + return checked
406 + for ext in dirs:
407 + pkg = read_pkg(ext)
408 + name = pkg["name"]
409 + version = pkg["version"]
410 + try:
411 + npm_publish(ext, otp)
412 + print(f"OK publish {name}@{version}")
413 + git_tag_release(name, version)
414 + except subprocess.CalledProcessError as e:
415 + print(f"ERROR publish {name}@{version}", file=sys.stderr)
416 + return e.returncode or 1
417 + return 0
230 420 def main() -> int:
231 421 parser = argparse.ArgumentParser()
232 422 sub = parser.add_subparsers(dest="command", required=True)
234 424 list_p.add_argument("extensions", nargs="*")
235 425 check_p = sub.add_parser("check")
236 426 check_p.add_argument("extensions", nargs="*")
427 + publish_p = sub.add_parser("publish")
428 + publish_p.add_argument("extensions", nargs="*")
429 + publish_p.add_argument("--otp")
430 + publish_p.add_argument("--bump", choices=["patch", "minor", "major"], default="patch")
237 431 args = parser.parse_args()
239 433 if args.command == "list":
240 434 return cmd_list(args.extensions)
241 435 if args.command == "check":
242 436 return cmd_check(args.extensions)
437 + if args.command == "publish":
438 + return cmd_publish(args.extensions, args.otp, args.bump)
243 439 raise AssertionError(args.command)