@mrquake/quakecode-cli 0.64.0 → 0.64.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (180) hide show
  1. package/dist/bun/cli.d.ts.map +1 -1
  2. package/dist/bun/cli.js +1 -1
  3. package/dist/bun/cli.js.map +1 -1
  4. package/dist/config.d.ts.map +1 -1
  5. package/dist/config.js +7 -10
  6. package/dist/config.js.map +1 -1
  7. package/dist/core/extensions/loader.d.ts.map +1 -1
  8. package/dist/core/extensions/loader.js +21 -7
  9. package/dist/core/extensions/loader.js.map +1 -1
  10. package/dist/core/settings-manager.d.ts.map +1 -1
  11. package/dist/core/settings-manager.js +2 -2
  12. package/dist/core/settings-manager.js.map +1 -1
  13. package/dist/core/slash-commands.d.ts.map +1 -1
  14. package/dist/core/slash-commands.js +1 -1
  15. package/dist/core/slash-commands.js.map +1 -1
  16. package/dist/core/system-prompt.d.ts.map +1 -1
  17. package/dist/core/system-prompt.js +5 -5
  18. package/dist/core/system-prompt.js.map +1 -1
  19. package/dist/main.d.ts.map +1 -1
  20. package/dist/main.js +7 -7
  21. package/dist/main.js.map +1 -1
  22. package/dist/migrations.d.ts.map +1 -1
  23. package/dist/migrations.js +2 -2
  24. package/dist/migrations.js.map +1 -1
  25. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  26. package/dist/modes/interactive/components/config-selector.js +1 -1
  27. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  28. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  29. package/dist/modes/interactive/components/session-selector.js +82 -105
  30. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  31. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  32. package/dist/modes/interactive/interactive-mode.js +10 -5
  33. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  34. package/dist/utils/clipboard-image.d.ts.map +1 -1
  35. package/dist/utils/clipboard-image.js +3 -3
  36. package/dist/utils/clipboard-image.js.map +1 -1
  37. package/package.json +14 -7
  38. package/docs/compaction.md +0 -394
  39. package/docs/custom-provider.md +0 -596
  40. package/docs/development.md +0 -71
  41. package/docs/extensions.md +0 -2286
  42. package/docs/images/doom-extension.png +0 -0
  43. package/docs/images/exy.png +0 -0
  44. package/docs/images/interactive-mode.png +0 -0
  45. package/docs/images/tree-view.png +0 -0
  46. package/docs/json.md +0 -82
  47. package/docs/keybindings.md +0 -175
  48. package/docs/models.md +0 -341
  49. package/docs/packages.md +0 -218
  50. package/docs/prompt-templates.md +0 -67
  51. package/docs/providers.md +0 -195
  52. package/docs/rpc.md +0 -1377
  53. package/docs/sdk.md +0 -1064
  54. package/docs/session.md +0 -412
  55. package/docs/settings.md +0 -246
  56. package/docs/shell-aliases.md +0 -13
  57. package/docs/skills.md +0 -232
  58. package/docs/terminal-setup.md +0 -106
  59. package/docs/termux.md +0 -127
  60. package/docs/themes.md +0 -295
  61. package/docs/tmux.md +0 -61
  62. package/docs/tree.md +0 -231
  63. package/docs/tui.md +0 -887
  64. package/docs/windows.md +0 -17
  65. package/examples/README.md +0 -25
  66. package/examples/extensions/README.md +0 -206
  67. package/examples/extensions/antigravity-image-gen.ts +0 -418
  68. package/examples/extensions/auto-commit-on-exit.ts +0 -49
  69. package/examples/extensions/bash-spawn-hook.ts +0 -30
  70. package/examples/extensions/bookmark.ts +0 -50
  71. package/examples/extensions/built-in-tool-renderer.ts +0 -246
  72. package/examples/extensions/claude-rules.ts +0 -86
  73. package/examples/extensions/commands.ts +0 -72
  74. package/examples/extensions/confirm-destructive.ts +0 -59
  75. package/examples/extensions/custom-compaction.ts +0 -127
  76. package/examples/extensions/custom-footer.ts +0 -64
  77. package/examples/extensions/custom-header.ts +0 -73
  78. package/examples/extensions/custom-provider-anthropic/index.ts +0 -604
  79. package/examples/extensions/custom-provider-anthropic/package-lock.json +0 -24
  80. package/examples/extensions/custom-provider-anthropic/package.json +0 -19
  81. package/examples/extensions/custom-provider-gitlab-duo/index.ts +0 -349
  82. package/examples/extensions/custom-provider-gitlab-duo/package.json +0 -16
  83. package/examples/extensions/custom-provider-gitlab-duo/test.ts +0 -82
  84. package/examples/extensions/custom-provider-qwen-cli/index.ts +0 -345
  85. package/examples/extensions/custom-provider-qwen-cli/package.json +0 -16
  86. package/examples/extensions/dirty-repo-guard.ts +0 -56
  87. package/examples/extensions/doom-overlay/README.md +0 -46
  88. package/examples/extensions/doom-overlay/doom/build/doom.js +0 -21
  89. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  90. package/examples/extensions/doom-overlay/doom/build.sh +0 -152
  91. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +0 -72
  92. package/examples/extensions/doom-overlay/doom-component.ts +0 -132
  93. package/examples/extensions/doom-overlay/doom-engine.ts +0 -173
  94. package/examples/extensions/doom-overlay/doom-keys.ts +0 -104
  95. package/examples/extensions/doom-overlay/index.ts +0 -74
  96. package/examples/extensions/doom-overlay/wad-finder.ts +0 -51
  97. package/examples/extensions/dynamic-resources/SKILL.md +0 -8
  98. package/examples/extensions/dynamic-resources/dynamic.json +0 -79
  99. package/examples/extensions/dynamic-resources/dynamic.md +0 -5
  100. package/examples/extensions/dynamic-resources/index.ts +0 -15
  101. package/examples/extensions/dynamic-tools.ts +0 -74
  102. package/examples/extensions/event-bus.ts +0 -43
  103. package/examples/extensions/file-trigger.ts +0 -41
  104. package/examples/extensions/git-checkpoint.ts +0 -53
  105. package/examples/extensions/handoff.ts +0 -153
  106. package/examples/extensions/hello.ts +0 -26
  107. package/examples/extensions/hidden-thinking-label.ts +0 -53
  108. package/examples/extensions/inline-bash.ts +0 -94
  109. package/examples/extensions/input-transform.ts +0 -43
  110. package/examples/extensions/interactive-shell.ts +0 -196
  111. package/examples/extensions/mac-system-theme.ts +0 -47
  112. package/examples/extensions/message-renderer.ts +0 -59
  113. package/examples/extensions/minimal-mode.ts +0 -426
  114. package/examples/extensions/modal-editor.ts +0 -85
  115. package/examples/extensions/model-status.ts +0 -31
  116. package/examples/extensions/notify.ts +0 -55
  117. package/examples/extensions/overlay-qa-tests.ts +0 -1348
  118. package/examples/extensions/overlay-test.ts +0 -150
  119. package/examples/extensions/permission-gate.ts +0 -34
  120. package/examples/extensions/pirate.ts +0 -47
  121. package/examples/extensions/plan-mode/README.md +0 -65
  122. package/examples/extensions/plan-mode/index.ts +0 -340
  123. package/examples/extensions/plan-mode/utils.ts +0 -168
  124. package/examples/extensions/preset.ts +0 -397
  125. package/examples/extensions/protected-paths.ts +0 -30
  126. package/examples/extensions/provider-payload.ts +0 -14
  127. package/examples/extensions/qna.ts +0 -122
  128. package/examples/extensions/question.ts +0 -264
  129. package/examples/extensions/questionnaire.ts +0 -427
  130. package/examples/extensions/rainbow-editor.ts +0 -88
  131. package/examples/extensions/reload-runtime.ts +0 -37
  132. package/examples/extensions/rpc-demo.ts +0 -118
  133. package/examples/extensions/sandbox/index.ts +0 -321
  134. package/examples/extensions/sandbox/package-lock.json +0 -92
  135. package/examples/extensions/sandbox/package.json +0 -19
  136. package/examples/extensions/send-user-message.ts +0 -97
  137. package/examples/extensions/session-name.ts +0 -27
  138. package/examples/extensions/shutdown-command.ts +0 -63
  139. package/examples/extensions/snake.ts +0 -343
  140. package/examples/extensions/space-invaders.ts +0 -560
  141. package/examples/extensions/ssh.ts +0 -220
  142. package/examples/extensions/status-line.ts +0 -32
  143. package/examples/extensions/subagent/README.md +0 -172
  144. package/examples/extensions/subagent/agents/planner.md +0 -37
  145. package/examples/extensions/subagent/agents/reviewer.md +0 -35
  146. package/examples/extensions/subagent/agents/scout.md +0 -50
  147. package/examples/extensions/subagent/agents/worker.md +0 -24
  148. package/examples/extensions/subagent/agents.ts +0 -126
  149. package/examples/extensions/subagent/index.ts +0 -986
  150. package/examples/extensions/subagent/prompts/implement-and-review.md +0 -10
  151. package/examples/extensions/subagent/prompts/implement.md +0 -10
  152. package/examples/extensions/subagent/prompts/scout-and-plan.md +0 -9
  153. package/examples/extensions/summarize.ts +0 -206
  154. package/examples/extensions/system-prompt-header.ts +0 -17
  155. package/examples/extensions/timed-confirm.ts +0 -70
  156. package/examples/extensions/titlebar-spinner.ts +0 -58
  157. package/examples/extensions/todo.ts +0 -297
  158. package/examples/extensions/tool-override.ts +0 -144
  159. package/examples/extensions/tools.ts +0 -141
  160. package/examples/extensions/trigger-compact.ts +0 -50
  161. package/examples/extensions/truncated-tool.ts +0 -195
  162. package/examples/extensions/widget-placement.ts +0 -9
  163. package/examples/extensions/with-deps/index.ts +0 -32
  164. package/examples/extensions/with-deps/package-lock.json +0 -31
  165. package/examples/extensions/with-deps/package.json +0 -22
  166. package/examples/rpc-extension-ui.ts +0 -632
  167. package/examples/sdk/01-minimal.ts +0 -22
  168. package/examples/sdk/02-custom-model.ts +0 -49
  169. package/examples/sdk/03-custom-prompt.ts +0 -55
  170. package/examples/sdk/04-skills.ts +0 -52
  171. package/examples/sdk/05-tools.ts +0 -56
  172. package/examples/sdk/06-extensions.ts +0 -88
  173. package/examples/sdk/07-context-files.ts +0 -40
  174. package/examples/sdk/08-prompt-templates.ts +0 -48
  175. package/examples/sdk/09-api-keys-and-oauth.ts +0 -48
  176. package/examples/sdk/10-settings.ts +0 -51
  177. package/examples/sdk/11-sessions.ts +0 -48
  178. package/examples/sdk/12-full-control.ts +0 -81
  179. package/examples/sdk/13-session-runtime.ts +0 -49
  180. package/examples/sdk/README.md +0 -145
@@ -1,94 +0,0 @@
1
- /**
2
- * Inline Bash Extension - expands inline bash commands in user prompts.
3
- *
4
- * Start pi with this extension:
5
- * pi -e ./examples/extensions/inline-bash.ts
6
- *
7
- * Then type prompts with inline bash:
8
- * What's in !{pwd}?
9
- * The current branch is !{git branch --show-current} and status: !{git status --short}
10
- * My node version is !{node --version}
11
- *
12
- * The !{command} patterns are executed and replaced with their output before
13
- * the prompt is sent to the agent.
14
- *
15
- * Note: Regular !command syntax (whole-line bash) is preserved and works as before.
16
- */
17
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
18
-
19
- export default function (pi: ExtensionAPI) {
20
- const PATTERN = /!\{([^}]+)\}/g;
21
- const TIMEOUT_MS = 30000;
22
-
23
- pi.on("input", async (event, ctx) => {
24
- const text = event.text;
25
-
26
- // Don't process if it's a whole-line bash command (starts with !)
27
- // This preserves the existing !command behavior
28
- if (text.trimStart().startsWith("!") && !text.trimStart().startsWith("!{")) {
29
- return { action: "continue" };
30
- }
31
-
32
- // Check if there are any inline bash patterns
33
- if (!PATTERN.test(text)) {
34
- return { action: "continue" };
35
- }
36
-
37
- // Reset regex state after test()
38
- PATTERN.lastIndex = 0;
39
-
40
- let result = text;
41
- const expansions: Array<{ command: string; output: string; error?: string }> = [];
42
-
43
- // Find all matches first (to avoid issues with replacing while iterating)
44
- const matches: Array<{ full: string; command: string }> = [];
45
- let match = PATTERN.exec(text);
46
- while (match) {
47
- matches.push({ full: match[0], command: match[1] });
48
- match = PATTERN.exec(text);
49
- }
50
-
51
- // Execute each command and collect results
52
- for (const { full, command } of matches) {
53
- try {
54
- const bashResult = await pi.exec("bash", ["-c", command], {
55
- timeout: TIMEOUT_MS,
56
- });
57
-
58
- const output = bashResult.stdout || bashResult.stderr || "";
59
- const trimmed = output.trim();
60
-
61
- if (bashResult.code !== 0 && bashResult.stderr) {
62
- expansions.push({
63
- command,
64
- output: trimmed,
65
- error: `exit code ${bashResult.code}`,
66
- });
67
- } else {
68
- expansions.push({ command, output: trimmed });
69
- }
70
-
71
- result = result.replace(full, trimmed);
72
- } catch (err) {
73
- const errorMsg = err instanceof Error ? err.message : String(err);
74
- expansions.push({ command, output: "", error: errorMsg });
75
- result = result.replace(full, `[error: ${errorMsg}]`);
76
- }
77
- }
78
-
79
- // Show what was expanded (if UI available)
80
- if (ctx.hasUI && expansions.length > 0) {
81
- const summary = expansions
82
- .map((e) => {
83
- const status = e.error ? ` (${e.error})` : "";
84
- const preview = e.output.length > 50 ? `${e.output.slice(0, 50)}...` : e.output;
85
- return `!{${e.command}}${status} -> "${preview}"`;
86
- })
87
- .join("\n");
88
-
89
- ctx.ui.notify(`Expanded ${expansions.length} inline command(s):\n${summary}`, "info");
90
- }
91
-
92
- return { action: "transform", text: result, images: event.images };
93
- });
94
- }
@@ -1,43 +0,0 @@
1
- /**
2
- * Input Transform Example - demonstrates the `input` event for intercepting user input.
3
- *
4
- * Start pi with this extension:
5
- * pi -e ./examples/extensions/input-transform.ts
6
- *
7
- * Then type these inside pi:
8
- * ?quick What is TypeScript? → "Respond briefly: What is TypeScript?"
9
- * ping → "pong" (instant, no LLM)
10
- * time → current time (instant, no LLM)
11
- */
12
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
13
-
14
- export default function (pi: ExtensionAPI) {
15
- pi.on("input", async (event, ctx) => {
16
- // Source-based logic: skip processing for extension-injected messages
17
- if (event.source === "extension") {
18
- return { action: "continue" };
19
- }
20
-
21
- // Transform: ?quick prefix for brief responses
22
- if (event.text.startsWith("?quick ")) {
23
- const query = event.text.slice(7).trim();
24
- if (!query) {
25
- ctx.ui.notify("Usage: ?quick <question>", "warning");
26
- return { action: "handled" };
27
- }
28
- return { action: "transform", text: `Respond briefly in 1-2 sentences: ${query}` };
29
- }
30
-
31
- // Handle: instant responses without LLM (extension shows its own feedback)
32
- if (event.text.toLowerCase() === "ping") {
33
- ctx.ui.notify("pong", "info");
34
- return { action: "handled" };
35
- }
36
- if (event.text.toLowerCase() === "time") {
37
- ctx.ui.notify(new Date().toLocaleString(), "info");
38
- return { action: "handled" };
39
- }
40
-
41
- return { action: "continue" };
42
- });
43
- }
@@ -1,196 +0,0 @@
1
- /**
2
- * Interactive Shell Commands Extension
3
- *
4
- * Enables running interactive commands (vim, git rebase -i, htop, etc.)
5
- * with full terminal access. The TUI suspends while they run.
6
- *
7
- * Usage:
8
- * pi -e examples/extensions/interactive-shell.ts
9
- *
10
- * !vim file.txt # Auto-detected as interactive
11
- * !i any-command # Force interactive mode with !i prefix
12
- * !git rebase -i HEAD~3
13
- * !htop
14
- *
15
- * Configuration via environment variables:
16
- * INTERACTIVE_COMMANDS - Additional commands (comma-separated)
17
- * INTERACTIVE_EXCLUDE - Commands to exclude (comma-separated)
18
- *
19
- * Note: This only intercepts user `!` commands, not agent bash tool calls.
20
- * If the agent runs an interactive command, it will fail (which is fine).
21
- */
22
-
23
- import { spawnSync } from "node:child_process";
24
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
25
-
26
- // Default interactive commands - editors, pagers, git ops, TUIs
27
- const DEFAULT_INTERACTIVE_COMMANDS = [
28
- // Editors
29
- "vim",
30
- "nvim",
31
- "vi",
32
- "nano",
33
- "emacs",
34
- "pico",
35
- "micro",
36
- "helix",
37
- "hx",
38
- "kak",
39
- // Pagers
40
- "less",
41
- "more",
42
- "most",
43
- // Git interactive
44
- "git commit",
45
- "git rebase",
46
- "git merge",
47
- "git cherry-pick",
48
- "git revert",
49
- "git add -p",
50
- "git add --patch",
51
- "git add -i",
52
- "git add --interactive",
53
- "git stash -p",
54
- "git stash --patch",
55
- "git reset -p",
56
- "git reset --patch",
57
- "git checkout -p",
58
- "git checkout --patch",
59
- "git difftool",
60
- "git mergetool",
61
- // System monitors
62
- "htop",
63
- "top",
64
- "btop",
65
- "glances",
66
- // File managers
67
- "ranger",
68
- "nnn",
69
- "lf",
70
- "mc",
71
- "vifm",
72
- // Git TUIs
73
- "tig",
74
- "lazygit",
75
- "gitui",
76
- // Fuzzy finders
77
- "fzf",
78
- "sk",
79
- // Remote sessions
80
- "ssh",
81
- "telnet",
82
- "mosh",
83
- // Database clients
84
- "psql",
85
- "mysql",
86
- "sqlite3",
87
- "mongosh",
88
- "redis-cli",
89
- // Kubernetes/Docker
90
- "kubectl edit",
91
- "kubectl exec -it",
92
- "docker exec -it",
93
- "docker run -it",
94
- // Other
95
- "tmux",
96
- "screen",
97
- "ncdu",
98
- ];
99
-
100
- function getInteractiveCommands(): string[] {
101
- const additional =
102
- process.env.INTERACTIVE_COMMANDS?.split(",")
103
- .map((s) => s.trim())
104
- .filter(Boolean) ?? [];
105
- const excluded = new Set(process.env.INTERACTIVE_EXCLUDE?.split(",").map((s) => s.trim().toLowerCase()) ?? []);
106
- return [...DEFAULT_INTERACTIVE_COMMANDS, ...additional].filter((cmd) => !excluded.has(cmd.toLowerCase()));
107
- }
108
-
109
- function isInteractiveCommand(command: string): boolean {
110
- const trimmed = command.trim().toLowerCase();
111
- const commands = getInteractiveCommands();
112
-
113
- for (const cmd of commands) {
114
- const cmdLower = cmd.toLowerCase();
115
- // Match at start
116
- if (trimmed === cmdLower || trimmed.startsWith(`${cmdLower} `) || trimmed.startsWith(`${cmdLower}\t`)) {
117
- return true;
118
- }
119
- // Match after pipe: "cat file | less"
120
- const pipeIdx = trimmed.lastIndexOf("|");
121
- if (pipeIdx !== -1) {
122
- const afterPipe = trimmed.slice(pipeIdx + 1).trim();
123
- if (afterPipe === cmdLower || afterPipe.startsWith(`${cmdLower} `)) {
124
- return true;
125
- }
126
- }
127
- }
128
- return false;
129
- }
130
-
131
- export default function (pi: ExtensionAPI) {
132
- pi.on("user_bash", async (event, ctx) => {
133
- let command = event.command;
134
- let forceInteractive = false;
135
-
136
- // Check for !i prefix (command comes without the leading !)
137
- // The prefix parsing happens before this event, so we check if command starts with "i "
138
- if (command.startsWith("i ") || command.startsWith("i\t")) {
139
- forceInteractive = true;
140
- command = command.slice(2).trim();
141
- }
142
-
143
- const shouldBeInteractive = forceInteractive || isInteractiveCommand(command);
144
- if (!shouldBeInteractive) {
145
- return; // Let normal handling proceed
146
- }
147
-
148
- // No UI available (print mode, RPC, etc.)
149
- if (!ctx.hasUI) {
150
- return {
151
- result: { output: "(interactive commands require TUI)", exitCode: 1, cancelled: false, truncated: false },
152
- };
153
- }
154
-
155
- // Use ctx.ui.custom() to get TUI access, then run the command
156
- const exitCode = await ctx.ui.custom<number | null>((tui, _theme, _kb, done) => {
157
- // Stop TUI to release terminal
158
- tui.stop();
159
-
160
- // Clear screen
161
- process.stdout.write("\x1b[2J\x1b[H");
162
-
163
- // Run command with full terminal access
164
- const shell = process.env.SHELL || "/bin/sh";
165
- const result = spawnSync(shell, ["-c", command], {
166
- stdio: "inherit",
167
- env: process.env,
168
- });
169
-
170
- // Restart TUI
171
- tui.start();
172
- tui.requestRender(true);
173
-
174
- // Signal completion
175
- done(result.status);
176
-
177
- // Return empty component (immediately disposed since done() was called)
178
- return { render: () => [], invalidate: () => {} };
179
- });
180
-
181
- // Return result to prevent default bash handling
182
- const output =
183
- exitCode === 0
184
- ? "(interactive command completed successfully)"
185
- : `(interactive command exited with code ${exitCode})`;
186
-
187
- return {
188
- result: {
189
- output,
190
- exitCode: exitCode ?? 1,
191
- cancelled: false,
192
- truncated: false,
193
- },
194
- };
195
- });
196
- }
@@ -1,47 +0,0 @@
1
- /**
2
- * Syncs pi theme with macOS system appearance (dark/light mode).
3
- *
4
- * Usage:
5
- * pi -e examples/extensions/mac-system-theme.ts
6
- */
7
-
8
- import { exec } from "node:child_process";
9
- import { promisify } from "node:util";
10
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
11
-
12
- const execAsync = promisify(exec);
13
-
14
- async function isDarkMode(): Promise<boolean> {
15
- try {
16
- const { stdout } = await execAsync(
17
- "osascript -e 'tell application \"System Events\" to tell appearance preferences to return dark mode'",
18
- );
19
- return stdout.trim() === "true";
20
- } catch {
21
- return false;
22
- }
23
- }
24
-
25
- export default function (pi: ExtensionAPI) {
26
- let intervalId: ReturnType<typeof setInterval> | null = null;
27
-
28
- pi.on("session_start", async (_event, ctx) => {
29
- let currentTheme = (await isDarkMode()) ? "dark" : "light";
30
- ctx.ui.setTheme(currentTheme);
31
-
32
- intervalId = setInterval(async () => {
33
- const newTheme = (await isDarkMode()) ? "dark" : "light";
34
- if (newTheme !== currentTheme) {
35
- currentTheme = newTheme;
36
- ctx.ui.setTheme(currentTheme);
37
- }
38
- }, 2000);
39
- });
40
-
41
- pi.on("session_shutdown", () => {
42
- if (intervalId) {
43
- clearInterval(intervalId);
44
- intervalId = null;
45
- }
46
- });
47
- }
@@ -1,59 +0,0 @@
1
- /**
2
- * Custom message rendering example.
3
- *
4
- * Shows how to use registerMessageRenderer to control how custom messages
5
- * appear in the TUI, with colors, formatting, and expandable details.
6
- *
7
- * Usage: /status [message] - sends a status message with custom rendering
8
- */
9
-
10
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
11
- import { Box, Text } from "@mariozechner/pi-tui";
12
-
13
- export default function (pi: ExtensionAPI) {
14
- // Register custom renderer for "status-update" messages
15
- pi.registerMessageRenderer("status-update", (message, { expanded }, theme) => {
16
- const details = message.details as { level: string; timestamp: number } | undefined;
17
- const level = details?.level ?? "info";
18
-
19
- // Color based on level
20
- const color = level === "error" ? "error" : level === "warn" ? "warning" : "success";
21
- const prefix = theme.fg(color, `[${level.toUpperCase()}]`);
22
-
23
- let text = `${prefix} ${message.content}`;
24
-
25
- // Show timestamp when expanded
26
- if (expanded && details?.timestamp) {
27
- const time = new Date(details.timestamp).toLocaleTimeString();
28
- text += `\n${theme.fg("dim", ` at ${time}`)}`;
29
- }
30
-
31
- // Use Box with customMessageBg for consistent styling
32
- const box = new Box(1, 1, (t) => theme.bg("customMessageBg", t));
33
- box.addChild(new Text(text, 0, 0));
34
- return box;
35
- });
36
-
37
- // Command to send status messages
38
- pi.registerCommand("status", {
39
- description: "Send a status message (usage: /status [warn|error] message)",
40
- handler: async (args, _ctx) => {
41
- const parts = args.trim().split(/\s+/);
42
- let level = "info";
43
- let content = args.trim();
44
-
45
- // Check for level prefix
46
- if (parts[0] === "warn" || parts[0] === "error") {
47
- level = parts[0];
48
- content = parts.slice(1).join(" ") || "Status update";
49
- }
50
-
51
- pi.sendMessage({
52
- customType: "status-update",
53
- content,
54
- display: true,
55
- details: { level, timestamp: Date.now() },
56
- });
57
- },
58
- });
59
- }