my-pi 0.0.5 → 0.0.7

package/README.md

@@ -70,6 +70,18 @@ Built-in extension choices can also be saved interactively with
 `/extensions`. Startup flags like `--no-recall` and `--no-skills`
 still force-disable those extensions for the current process only.
 
+### Themes
+
+`my-pi` ships a bundled theme pack from `./themes` and loads it into
+the runtime automatically. Pick a theme in `/settings`, or persist one
+via Pi settings JSON:
+
+```json
+{
+	"theme": "tokyo-night"
+}
+```
+
 ### Stdin piping
 
 ```bash
@@ -158,6 +170,17 @@ In interactive mode:
 - `/skills sync <key|name>` — sync an imported skill to its upstream
 - `/skills refresh` — rescan skill directories
 - `/skills defaults <all-enabled|all-disabled>` — set default policy
+- `/preset` — open the prompt preset manager (base presets + layers)
+- `/preset <name>` — activate a base preset or toggle a layer
+- `/preset base <name>` — activate a base preset directly
+- `/preset enable <layer>` / `/preset disable <layer>` — toggle a
+  prompt layer directly
+- `/preset edit <name>` — edit or create a project-local preset in
+  `.pi/presets.json`
+- `/preset delete <name>` — delete a project-local preset
+- `/preset reset <name>` — remove a project-local override and fall
+  back to user/built-in if available
+- `/preset clear` — clear the active base preset and all layers
 
 ### How it works
 
@@ -212,6 +235,46 @@ them. Detection patterns from
 Use `/redact-stats` to see how many secrets were caught. Disable with
 `--no-filter`.
 
+## Prompt Presets
+
+Prompt presets append runtime instructions to the system prompt
+through a built-in extension. They are split into:
+
+- **base presets** — one active at a time
+- **prompt layers** — additive checkboxes you can combine
+
+Built-in base presets:
+
+- `terse` — short, direct, no fluff
+- `standard` — clear and concise with key context
+- `detailed` — more explanation when nuance matters
+
+Built-in layers:
+
+- `no-purple-prose`
+- `bullets`
+- `clarify-first`
+- `include-risks`
+
+Preset sources are merged in this order:
+
+1. built-in defaults
+2. `~/.pi/agent/presets.json`
+3. `.pi/presets.json`
+
+Project presets override global/default presets with the same name.
+Strings are treated as base presets by default. Object entries may set
+`kind: "base"` or `kind: "layer"`.
+
+CLI layering is supported too:
+
+- `--preset terse,no-purple-prose,bullets`
+- `--system-prompt "You are terse and technical."`
+- `--append-system-prompt "Prefer one short paragraph."`
+
+This repo also includes an example `.pi/presets.json` with sample base
+presets and layers.
+
 ## Session Handoff
 
 Use `/handoff <task>` to export conversation context as a markdown
@@ -237,6 +300,7 @@ src/
     chain.ts          Agent chain pipelines
     filter-output.ts  Secret redaction in tool output
     handoff.ts        Session context export
+    prompt-presets.ts Runtime prompt preset selection and editing
     recall.ts         Past session recall guidance
   mcp/
     client.ts         Minimal MCP stdio client (JSON-RPC 2.0)
@@ -249,6 +313,7 @@ src/
   agents/
     *.md              Agent definitions (frontmatter + system prompt)
     agent-chain.yaml  Chain pipeline definitions
+  presets.json        Optional project prompt presets
 mcp.json              Project MCP server config
 ```