pi-caveman 1.0.2 → 1.0.4

package/README.md

@@ -45,7 +45,10 @@ pi install git:github.com/jonjonrankin/pi-caveman
 /caveman wenyan-lite  Semi-classical Chinese
 /caveman wenyan       Full 文言文
 /caveman wenyan-ultra Extreme 文言文
+/caveman micro        Experimental prompt-minimized mode
 /caveman off          Disable
+/caveman stop         Disable (alias)
+/caveman quit         Disable (alias)
 ```
 
 ### Settings
@@ -63,24 +66,19 @@ Settings are saved to `~/.pi/agent/caveman.json` and persist across all sessions
 
 ### Status Bar
 
-When active, an animated campfire flickers in the footer using colored braille characters:
-
-```
-⠠⠄ → ⠔⠂ → ⠊⠑ → ...   colored campfire embers (speed varies by level)
-```
-
-Colors cycle through red → orange → yellow → white-hot → ember using ANSI 256-color. Speed scales with intensity: 300ms for lite, 200ms for full, 100ms for ultra.
+When active, a status bar displays caveman level and an animated campfire flickers in the footer using colored braille characters. This can be disabled in the `/caveman config` menu.
 
 ## Levels
 
-| Level | Style | Example |
-|-------|-------|---------|
-| **Lite** | No filler. Full sentences. Professional but tight. | "Your component re-renders because you create a new object reference each render." |
-| **Full** | Drop articles, fragments OK. Classic caveman. | "New object ref each render. Wrap in `useMemo`." |
-| **Ultra** | Abbreviations, arrows, maximum compression. | "Inline obj prop → new ref → re-render. `useMemo`." |
-| **文言文 Lite** | Semi-classical Chinese, grammar intact. | "組件頻重繪，以每繪新生對象參照故。" |
-| **文言文** | Full classical terseness. | "物出新參照，致重繪。useMemo Wrap之。" |
-| **文言文 Ultra** | Extreme classical compression. | "新參照→重繪。useMemo Wrap。" |
+| Level                      | Style                                                                                                                      | Example                                                                            |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| **Lite**                   | No filler. Full sentences. Professional but tight.                                                                         | "Your component re-renders because you create a new object reference each render." |
+| **Full**                   | Drop articles, fragments OK. Classic caveman.                                                                              | "New object ref each render. Wrap in `useMemo`."                                   |
+| **Ultra**                  | Abbreviations, arrows, maximum compression.                                                                                | "Inline obj prop → new ref → re-render. `useMemo`."                                |
+| **文言文 Lite**            | Semi-classical Chinese, grammar intact.                                                                                    | "組件頻重繪，以每繪新生對象參照故。"                                               |
+| **文言文**                 | Full classical terseness.                                                                                                  | "物出新參照，致重繪。useMemo Wrap之。"                                             |
+| **文言文 Ultra**           | Extreme classical compression.                                                                                             | "新參照→重繪。useMemo Wrap。"                                                      |
+| **Micro** _(experimental)_ | Minimal prompt that reduces size of caveman prompt itself. Drops filler, pleasantries, hedging, keeps technical substance. | "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"                |
 
 ## How It Works
 
@@ -90,6 +88,8 @@ The extension hooks `before_agent_start` to append caveman communication rules t
 
 Based on [caveman](https://github.com/JuliusBrussee/caveman) by [Julius Brussee](https://github.com/JuliusBrussee).
 
+`micro` mode prompt based on [caveman-micro](https://github.com/kuba-guzik/caveman-micro) by [Kuba Guzik](https://github.com/kuba-guzik).
+
 ## License
 
 MIT

package/extensions/caveman.ts

@@ -6,6 +6,7 @@
  *
  * Commands:
  *   /caveman [level]  Toggle caveman mode or set intensity
+ *   /caveman stop     Disable caveman mode (aliases: off, quit)
  *   /caveman config   Open settings dialog (default level, status bar toggle)
  */
 
@@ -20,9 +21,24 @@ import { Container, type SettingItem, SettingsList, Text } from "@mariozechner/p
 // Levels
 // ---------------------------------------------------------------------------
 
-const LEVELS = ["off", "lite", "full", "ultra", "wenyan-lite", "wenyan", "wenyan-ultra"] as const;
+const LEVELS = ["off", "lite", "full", "ultra", "wenyan-lite", "wenyan", "wenyan-ultra", "micro"] as const;
+const STOP_ALIASES = new Set(["off", "stop", "quit"]);
 type Level = (typeof LEVELS)[number];
 
+const CAVEMAN_COMMAND_OPTIONS = [
+	{ value: "lite", label: "lite", description: "Professional, no fluff" },
+	{ value: "full", label: "full", description: "Classic caveman" },
+	{ value: "ultra", label: "ultra", description: "Maximum compression" },
+	{ value: "wenyan-lite", label: "wenyan-lite", description: "Semi-classical Chinese" },
+	{ value: "wenyan", label: "wenyan", description: "Full 文言文" },
+	{ value: "wenyan-ultra", label: "wenyan-ultra", description: "Extreme 文言文" },
+	{ value: "micro", label: "micro", description: "Experimental prompt-minimized mode" },
+	{ value: "off", label: "off", description: "Disable caveman mode" },
+	{ value: "stop", label: "stop", description: "Disable caveman mode" },
+	{ value: "quit", label: "quit", description: "Disable caveman mode" },
+	{ value: "config", label: "config", description: "Open settings dialog" },
+] as const;
+
 // ---------------------------------------------------------------------------
 // Persistent config (survives across sessions)
 // ---------------------------------------------------------------------------
@@ -35,7 +51,8 @@ interface CavemanConfig {
 }
 
 const CONFIG_PATH = join(homedir(), ".pi", "agent", "caveman.json");
-const DEFAULT_CONFIG: CavemanConfig = { defaultLevel: "off", showStatus: true };
+const DEFAULT_CONFIG: CavemanConfig = { defaultLevel: "full", showStatus: true };
+let saveConfigQueue: Promise<void> = Promise.resolve();
 
 async function loadConfig(): Promise<CavemanConfig> {
 	try {
@@ -51,8 +68,12 @@ async function loadConfig(): Promise<CavemanConfig> {
 }
 
 async function saveConfig(config: CavemanConfig): Promise<void> {
-	await mkdir(join(homedir(), ".pi", "agent"), { recursive: true });
-	await writeFile(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf8");
+	const snapshot = JSON.stringify(config, null, 2) + "\n";
+	saveConfigQueue = saveConfigQueue.then(async () => {
+		await mkdir(join(homedir(), ".pi", "agent"), { recursive: true });
+		await writeFile(CONFIG_PATH, snapshot, "utf8");
+	});
+	return saveConfigQueue;
 }
 
 // ---------------------------------------------------------------------------
@@ -85,12 +106,13 @@ const FIRE_FRAMES = [
 ];
 
 const ANIMATIONS: Record<Exclude<Level, "off">, Animation> = {
-	lite:          { frames: FIRE_FRAMES, label: "LITE",   interval: 300 },
-	full:          { frames: FIRE_FRAMES, label: "CAVEMAN", interval: 200 },
-	ultra:         { frames: FIRE_FRAMES, label: "ULTRA",  interval: 100 },
-	"wenyan-lite": { frames: FIRE_FRAMES, label: "文言",    interval: 300 },
-	wenyan:        { frames: FIRE_FRAMES, label: "文言文",   interval: 200 },
-	"wenyan-ultra":{ frames: FIRE_FRAMES, label: "文言文極",  interval: 100 },
+	lite:           { frames: FIRE_FRAMES, label: "LITE", interval: 300 },
+	full:           { frames: FIRE_FRAMES, label: "FULL", interval: 200 },
+	ultra:          { frames: FIRE_FRAMES, label: "ULTRA", interval: 100 },
+	"wenyan-lite": { frames: FIRE_FRAMES, label: "文言", interval: 300 },
+	wenyan:         { frames: FIRE_FRAMES, label: "文言文", interval: 200 },
+	"wenyan-ultra": { frames: FIRE_FRAMES, label: "文言文極", interval: 100 },
+	micro:          { frames: FIRE_FRAMES, label: "MICRO", interval: 120 },
 };
 
 // ---------------------------------------------------------------------------
@@ -111,7 +133,15 @@ pleasantries, hedging
 Bad: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
 Good: "Bug in auth middleware. Token expiry check use \`<\` not \`<=\`. Fix:"`;
 
-const INTENSITY: Record<Exclude<Level, "off">, string> = {
+const MICRO_PROMPT = `# Token efficiency
+Respond like smart caveman. Cut all filler, keep technical substance.
+- Drop articles (a, an, the), filler (just, really, basically, actually).
+- Drop pleasantries (sure, certainly, happy to).
+- No hedging. Fragments fine. Short synonyms.
+- Technical terms stay exact. Code blocks unchanged.
+- Pattern: [thing] [action] [reason]. [next step].`;
+
+const INTENSITY: Record<Exclude<Level, "off" | "micro">, string> = {
 	lite: `\
 No filler/hedging. Keep articles + full sentences. Professional but tight.
 Example: "Your component re-renders because you create a new object reference each render. Wrap it in \`useMemo\`."`,
@@ -151,6 +181,20 @@ export default function caveman(pi: ExtensionAPI) {
 	let config: CavemanConfig = { ...DEFAULT_CONFIG };
 	let timer: ReturnType<typeof setInterval> | null = null;
 	let frameIndex = 0;
+	let isActive = false;
+	let configLoadPromise: Promise<void> | null = null;
+
+	const ensureConfigLoaded = async () => {
+		if (!configLoadPromise) {
+			configLoadPromise = (async () => {
+				config = await loadConfig();
+				if (level === "off" && config.defaultLevel !== "off") {
+					level = config.defaultLevel;
+				}
+			})();
+		}
+		await configLoadPromise;
+	};
 
 	// -- Animation helpers --
 
@@ -172,10 +216,17 @@ export default function caveman(pi: ExtensionAPI) {
 		}
 
 		const anim = ANIMATIONS[level];
+		const setFrame = (frame: string) => {
+			ctx.ui.setStatus("caveman", frame + " " + theme.fg("muted", "caveman level: ") + theme.fg("text", anim.label));
+		};
+
+		if (!isActive) {
+			setFrame(anim.frames[0]!);
+			return;
+		}
 
 		const renderFrame = () => {
-			const icon = anim.frames[frameIndex % anim.frames.length]!;
-			ctx.ui.setStatus("caveman", icon + " " + theme.fg("muted", "caveman level: ") + theme.fg("text", anim.label));
+			setFrame(anim.frames[frameIndex % anim.frames.length]!);
 			frameIndex++;
 		};
 
@@ -186,7 +237,7 @@ export default function caveman(pi: ExtensionAPI) {
 	// -- Restore state on session load --
 
 	pi.on("session_start", async (_event, ctx) => {
-		config = await loadConfig();
+		await ensureConfigLoaded();
 
 		// Check for session-level override first (resuming a session)
 		let sessionLevel: Level | null = null;
@@ -208,14 +259,30 @@ export default function caveman(pi: ExtensionAPI) {
 		syncStatus(ctx);
 	});
 
+	pi.on("agent_start", async (_event, ctx) => {
+		isActive = true;
+		syncStatus(ctx);
+	});
+
+	pi.on("agent_end", async (_event, ctx) => {
+		isActive = false;
+		syncStatus(ctx);
+	});
+
 	pi.on("session_shutdown", async () => {
 		stopAnimation();
+		isActive = false;
 	});
 
 	// -- /caveman command --
 
 	pi.registerCommand("caveman", {
-		description: "Toggle caveman mode, set level, or 'config' to open settings",
+		description: "Toggle caveman mode, set level, use stop/off/quit to disable, or 'config' to open settings",
+		getArgumentCompletions: (prefix: string) => {
+			const normalized = prefix.trim().toLowerCase();
+			const items = CAVEMAN_COMMAND_OPTIONS.filter((item) => item.value.startsWith(normalized));
+			return items.length > 0 ? items : null;
+		},
 		handler: async (args, ctx) => {
 			const arg = args?.trim().toLowerCase();
 
@@ -227,10 +294,12 @@ export default function caveman(pi: ExtensionAPI) {
 
 			if (!arg) {
 				level = level === "off" ? "full" : "off";
+			} else if (STOP_ALIASES.has(arg)) {
+				level = "off";
 			} else if (LEVELS.includes(arg as Level)) {
 				level = arg as Level;
 			} else {
-				ctx.ui.notify(`Unknown: "${arg}". Use: ${LEVELS.join(", ")} or config`, "error");
+				ctx.ui.notify(`Unknown: "${arg}". Use: ${LEVELS.join(", ")}, stop, quit, or config`, "error");
 				return;
 			}
 
@@ -247,7 +316,7 @@ export default function caveman(pi: ExtensionAPI) {
 	// -- /caveman config: interactive SettingsList --
 
 	async function openConfig(ctx: ExtensionContext) {
-		config = await loadConfig();
+		await ensureConfigLoaded();
 
 		await ctx.ui.custom((_tui, theme, _kb, done) => {
 			const items: SettingItem[] = [
@@ -268,32 +337,65 @@ export default function caveman(pi: ExtensionAPI) {
 			const container = new Container();
 			container.addChild(new Text(theme.fg("accent", theme.bold(" Caveman Config")), 0, 0));
 			container.addChild(new Text(theme.fg("dim", " Saved to ~/.pi/agent/caveman.json"), 0, 0));
+			container.addChild(new Text(theme.fg("dim", " Default level applies to future sessions."), 0, 0));
 			container.addChild(new Text("", 0, 0));
 
+			const applySettingChange = (id: string, newValue: string) => {
+				if (id === "defaultLevel" && LEVELS.includes(newValue as Level)) {
+					config.defaultLevel = newValue as Level;
+				} else if (id === "showStatus") {
+					config.showStatus = newValue === "on";
+				}
+				saveConfig(config);
+				syncStatus(ctx);
+			};
+
 			const settingsList = new SettingsList(
 				items,
 				Math.min(items.length + 2, 10),
 				getSettingsListTheme(),
-				(id, newValue) => {
-					if (id === "defaultLevel" && LEVELS.includes(newValue as Level)) {
-						config.defaultLevel = newValue as Level;
-					} else if (id === "showStatus") {
-						config.showStatus = newValue === "on";
-					}
-					saveConfig(config);
-					syncStatus(ctx);
-				},
+				applySettingChange,
 				() => done(undefined),
 			);
 
 			container.addChild(settingsList);
-			container.addChild(new Text(theme.fg("dim", " ←→ change • esc close"), 0, 0));
+			container.addChild(new Text(theme.fg("dim", " ←→/hl/tab change • ↑↓/jk move • esc close"), 0, 0));
+
+			const cycleSelectedValue = (direction: -1 | 1) => {
+				const selectedIndex = (settingsList as unknown as { selectedIndex: number }).selectedIndex;
+				const item = items[selectedIndex];
+				if (!item?.values?.length) return;
+
+				const currentIndex = item.values.indexOf(item.currentValue);
+				const nextIndex = (currentIndex + direction + item.values.length) % item.values.length;
+				const newValue = item.values[nextIndex]!;
+				item.currentValue = newValue;
+				settingsList.updateValue(item.id, newValue);
+				applySettingChange(item.id, newValue);
+			};
 
 			return {
 				render: (w: number) => container.render(w),
 				invalidate: () => container.invalidate(),
 				handleInput: (data: string) => {
+					if (data === "j") data = "\u001b[B";
+					else if (data === "k") data = "\u001b[A";
+					else if (data === "h") {
+						cycleSelectedValue(-1);
+						_tui.requestRender();
+						return;
+					} else if (data === "l" || data === "\u001b[C" || data === "\t") {
+						cycleSelectedValue(1);
+						_tui.requestRender();
+						return;
+					} else if (data === "\u001b[D") {
+						cycleSelectedValue(-1);
+						_tui.requestRender();
+						return;
+					}
+
 					settingsList.handleInput?.(data);
+					_tui.requestRender();
 				},
 			};
 		});
@@ -302,7 +404,13 @@ export default function caveman(pi: ExtensionAPI) {
 	// -- Inject caveman rules into system prompt --
 
 	pi.on("before_agent_start", async (event) => {
+		await ensureConfigLoaded();
 		if (level === "off") return;
+		if (level === "micro") {
+			return {
+				systemPrompt: `${event.systemPrompt}\n\n${MICRO_PROMPT}`,
+			};
+		}
 		return {
 			systemPrompt: `${event.systemPrompt}\n\n${BASE}\n\n${INTENSITY[level]}\n\n${SAFETY}`,
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-caveman",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Why use many token when few do trick. Caveman mode for pi — cuts ~75% output tokens while keeping full technical accuracy.",
   "keywords": [
     "pi-package",