@draht/coding-agent 2026.3.25 → 2026.4.23

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 (265) hide show
  1. package/CHANGELOG.md +896 -624
  2. package/README.md +110 -97
  3. package/dist/cli/args.d.ts +7 -10
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +42 -44
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/cli.d.ts.map +1 -1
  8. package/dist/cli.js +1 -0
  9. package/dist/cli.js.map +1 -1
  10. package/dist/config.d.ts +9 -0
  11. package/dist/config.d.ts.map +1 -1
  12. package/dist/config.js +18 -0
  13. package/dist/config.js.map +1 -1
  14. package/dist/core/agent-session-runtime.d.ts +83 -0
  15. package/dist/core/agent-session-runtime.d.ts.map +1 -0
  16. package/dist/core/agent-session-runtime.js +236 -0
  17. package/dist/core/agent-session-runtime.js.map +1 -0
  18. package/dist/core/agent-session-services.d.ts +86 -0
  19. package/dist/core/agent-session-services.d.ts.map +1 -0
  20. package/dist/core/agent-session-services.js +116 -0
  21. package/dist/core/agent-session-services.js.map +1 -0
  22. package/dist/core/agent-session.d.ts +17 -47
  23. package/dist/core/agent-session.d.ts.map +1 -1
  24. package/dist/core/agent-session.js +166 -291
  25. package/dist/core/agent-session.js.map +1 -1
  26. package/dist/core/auth-storage.d.ts +3 -1
  27. package/dist/core/auth-storage.d.ts.map +1 -1
  28. package/dist/core/auth-storage.js +5 -2
  29. package/dist/core/auth-storage.js.map +1 -1
  30. package/dist/core/bash-executor.d.ts.map +1 -1
  31. package/dist/core/bash-executor.js +19 -7
  32. package/dist/core/bash-executor.js.map +1 -1
  33. package/dist/core/compaction/branch-summarization.d.ts +2 -0
  34. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  35. package/dist/core/compaction/branch-summarization.js +2 -2
  36. package/dist/core/compaction/branch-summarization.js.map +1 -1
  37. package/dist/core/compaction/compaction.d.ts +3 -3
  38. package/dist/core/compaction/compaction.d.ts.map +1 -1
  39. package/dist/core/compaction/compaction.js +27 -26
  40. package/dist/core/compaction/compaction.js.map +1 -1
  41. package/dist/core/export-html/tool-renderer.d.ts +2 -0
  42. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  43. package/dist/core/export-html/tool-renderer.js +2 -2
  44. package/dist/core/export-html/tool-renderer.js.map +1 -1
  45. package/dist/core/extensions/index.d.ts +2 -2
  46. package/dist/core/extensions/index.d.ts.map +1 -1
  47. package/dist/core/extensions/index.js +1 -1
  48. package/dist/core/extensions/index.js.map +1 -1
  49. package/dist/core/extensions/loader.d.ts.map +1 -1
  50. package/dist/core/extensions/loader.js +7 -7
  51. package/dist/core/extensions/loader.js.map +1 -1
  52. package/dist/core/extensions/runner.d.ts +1 -0
  53. package/dist/core/extensions/runner.d.ts.map +1 -1
  54. package/dist/core/extensions/runner.js +4 -0
  55. package/dist/core/extensions/runner.js.map +1 -1
  56. package/dist/core/extensions/types.d.ts +30 -29
  57. package/dist/core/extensions/types.d.ts.map +1 -1
  58. package/dist/core/extensions/types.js +10 -0
  59. package/dist/core/extensions/types.js.map +1 -1
  60. package/dist/core/footer-data-provider.d.ts +5 -1
  61. package/dist/core/footer-data-provider.d.ts.map +1 -1
  62. package/dist/core/footer-data-provider.js +70 -8
  63. package/dist/core/footer-data-provider.js.map +1 -1
  64. package/dist/core/index.d.ts +3 -1
  65. package/dist/core/index.d.ts.map +1 -1
  66. package/dist/core/index.js +3 -1
  67. package/dist/core/index.js.map +1 -1
  68. package/dist/core/keybindings.d.ts +14 -1
  69. package/dist/core/keybindings.d.ts.map +1 -1
  70. package/dist/core/keybindings.js +13 -14
  71. package/dist/core/keybindings.js.map +1 -1
  72. package/dist/core/model-registry.d.ts +21 -3
  73. package/dist/core/model-registry.d.ts.map +1 -1
  74. package/dist/core/model-registry.js +120 -71
  75. package/dist/core/model-registry.js.map +1 -1
  76. package/dist/core/model-resolver.d.ts.map +1 -1
  77. package/dist/core/model-resolver.js +4 -4
  78. package/dist/core/model-resolver.js.map +1 -1
  79. package/dist/core/package-manager.d.ts +21 -1
  80. package/dist/core/package-manager.d.ts.map +1 -1
  81. package/dist/core/package-manager.js +108 -43
  82. package/dist/core/package-manager.js.map +1 -1
  83. package/dist/core/prompt-templates.d.ts.map +1 -1
  84. package/dist/core/prompt-templates.js +1 -22
  85. package/dist/core/prompt-templates.js.map +1 -1
  86. package/dist/core/resolve-config-value.d.ts +6 -0
  87. package/dist/core/resolve-config-value.d.ts.map +1 -1
  88. package/dist/core/resolve-config-value.js +37 -5
  89. package/dist/core/resolve-config-value.js.map +1 -1
  90. package/dist/core/resource-loader.d.ts.map +1 -1
  91. package/dist/core/resource-loader.js +25 -3
  92. package/dist/core/resource-loader.js.map +1 -1
  93. package/dist/core/sdk.d.ts +7 -4
  94. package/dist/core/sdk.d.ts.map +1 -1
  95. package/dist/core/sdk.js +18 -24
  96. package/dist/core/sdk.js.map +1 -1
  97. package/dist/core/session-cwd.d.ts +19 -0
  98. package/dist/core/session-cwd.d.ts.map +1 -0
  99. package/dist/core/session-cwd.js +38 -0
  100. package/dist/core/session-cwd.js.map +1 -0
  101. package/dist/core/session-manager.d.ts +5 -1
  102. package/dist/core/session-manager.d.ts.map +1 -1
  103. package/dist/core/session-manager.js +16 -8
  104. package/dist/core/session-manager.js.map +1 -1
  105. package/dist/core/settings-manager.d.ts +3 -1
  106. package/dist/core/settings-manager.d.ts.map +1 -1
  107. package/dist/core/settings-manager.js +5 -1
  108. package/dist/core/settings-manager.js.map +1 -1
  109. package/dist/core/skills.d.ts +1 -1
  110. package/dist/core/skills.d.ts.map +1 -1
  111. package/dist/core/skills.js +3 -3
  112. package/dist/core/skills.js.map +1 -1
  113. package/dist/core/system-prompt.d.ts.map +1 -1
  114. package/dist/core/system-prompt.js +6 -6
  115. package/dist/core/system-prompt.js.map +1 -1
  116. package/dist/core/timings.d.ts +1 -0
  117. package/dist/core/timings.d.ts.map +1 -1
  118. package/dist/core/timings.js +6 -0
  119. package/dist/core/timings.js.map +1 -1
  120. package/dist/core/tools/bash.d.ts.map +1 -1
  121. package/dist/core/tools/bash.js +19 -9
  122. package/dist/core/tools/bash.js.map +1 -1
  123. package/dist/core/tools/edit-diff.d.ts +23 -1
  124. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  125. package/dist/core/tools/edit-diff.js +150 -57
  126. package/dist/core/tools/edit-diff.js.map +1 -1
  127. package/dist/core/tools/edit.d.ts +13 -11
  128. package/dist/core/tools/edit.d.ts.map +1 -1
  129. package/dist/core/tools/edit.js +55 -77
  130. package/dist/core/tools/edit.js.map +1 -1
  131. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  132. package/dist/core/tools/file-mutation-queue.js +4 -4
  133. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  134. package/dist/core/tools/index.d.ts +9 -6
  135. package/dist/core/tools/index.d.ts.map +1 -1
  136. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  137. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  138. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  139. package/dist/index.d.ts +4 -6
  140. package/dist/index.d.ts.map +1 -1
  141. package/dist/index.js +4 -6
  142. package/dist/index.js.map +1 -1
  143. package/dist/main.d.ts.map +1 -1
  144. package/dist/main.js +259 -422
  145. package/dist/main.js.map +1 -1
  146. package/dist/migrations.d.ts +3 -3
  147. package/dist/migrations.d.ts.map +1 -1
  148. package/dist/migrations.js +25 -5
  149. package/dist/migrations.js.map +1 -1
  150. package/dist/modes/interactive/components/assistant-message.d.ts +3 -1
  151. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  152. package/dist/modes/interactive/components/assistant-message.js +14 -3
  153. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  154. package/dist/modes/interactive/components/earendil-announcement.d.ts +5 -0
  155. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -0
  156. package/dist/modes/interactive/components/earendil-announcement.js +40 -0
  157. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -0
  158. package/dist/modes/interactive/components/footer.d.ts +1 -0
  159. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  160. package/dist/modes/interactive/components/footer.js +4 -1
  161. package/dist/modes/interactive/components/footer.js.map +1 -1
  162. package/dist/modes/interactive/components/tool-execution.d.ts +0 -1
  163. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  164. package/dist/modes/interactive/components/tool-execution.js +2 -7
  165. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  166. package/dist/modes/interactive/components/tree-selector.d.ts +4 -2
  167. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  168. package/dist/modes/interactive/components/tree-selector.js +48 -15
  169. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  170. package/dist/modes/interactive/interactive-mode.d.ts +18 -5
  171. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  172. package/dist/modes/interactive/interactive-mode.js +287 -188
  173. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  174. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  175. package/dist/modes/interactive/theme/theme.js +15 -11
  176. package/dist/modes/interactive/theme/theme.js.map +1 -1
  177. package/dist/modes/print-mode.d.ts +2 -2
  178. package/dist/modes/print-mode.d.ts.map +1 -1
  179. package/dist/modes/print-mode.js +89 -72
  180. package/dist/modes/print-mode.js.map +1 -1
  181. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  182. package/dist/modes/rpc/rpc-client.js +1 -0
  183. package/dist/modes/rpc/rpc-client.js.map +1 -1
  184. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  185. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  186. package/dist/modes/rpc/rpc-mode.js +95 -64
  187. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  188. package/dist/package-manager-cli.d.ts +4 -0
  189. package/dist/package-manager-cli.d.ts.map +1 -0
  190. package/dist/package-manager-cli.js +234 -0
  191. package/dist/package-manager-cli.js.map +1 -0
  192. package/dist/prompts/commands/atomic-commit.md +17 -0
  193. package/dist/prompts/commands/discuss-phase.md +15 -0
  194. package/dist/prompts/commands/execute-phase.md +14 -0
  195. package/dist/prompts/commands/fix.md +14 -0
  196. package/dist/prompts/commands/init-project.md +16 -0
  197. package/dist/prompts/commands/map-codebase.md +16 -0
  198. package/dist/prompts/commands/new-project.md +16 -0
  199. package/dist/prompts/commands/next-milestone.md +16 -0
  200. package/dist/prompts/commands/pause-work.md +13 -0
  201. package/dist/prompts/commands/plan-phase.md +15 -0
  202. package/dist/prompts/commands/progress.md +13 -0
  203. package/dist/prompts/commands/quick.md +14 -0
  204. package/dist/prompts/commands/resume-work.md +13 -0
  205. package/dist/prompts/commands/review.md +15 -0
  206. package/dist/prompts/commands/verify-work.md +15 -0
  207. package/dist/utils/paths.d.ts +7 -0
  208. package/dist/utils/paths.d.ts.map +1 -0
  209. package/dist/utils/paths.js +19 -0
  210. package/dist/utils/paths.js.map +1 -0
  211. package/docs/compaction.md +5 -3
  212. package/docs/custom-provider.md +1 -1
  213. package/docs/development.md +5 -3
  214. package/docs/extensions.md +221 -69
  215. package/docs/json.md +5 -2
  216. package/docs/keybindings.md +2 -0
  217. package/docs/models.md +60 -3
  218. package/docs/packages.md +3 -3
  219. package/docs/rpc.md +23 -9
  220. package/docs/sdk.md +240 -84
  221. package/docs/session.md +3 -3
  222. package/docs/settings.md +12 -0
  223. package/docs/skills.md +3 -2
  224. package/docs/tree.md +6 -3
  225. package/examples/README.md +1 -1
  226. package/examples/extensions/README.md +1 -0
  227. package/examples/extensions/antigravity-image-gen.ts +1 -1
  228. package/examples/extensions/custom-compaction.ts +17 -4
  229. package/examples/extensions/custom-provider-gitlab-duo/index.ts +1 -1
  230. package/examples/extensions/doom-overlay/doom/build.sh +2 -2
  231. package/examples/extensions/handoff.ts +5 -2
  232. package/examples/extensions/hello.ts +18 -17
  233. package/examples/extensions/hidden-thinking-label.ts +53 -0
  234. package/examples/extensions/overlay-qa-tests.ts +2 -2
  235. package/examples/extensions/qna.ts +5 -2
  236. package/examples/extensions/rpc-demo.ts +3 -9
  237. package/examples/extensions/sandbox/index.ts +8 -4
  238. package/examples/extensions/status-line.ts +0 -8
  239. package/examples/extensions/subagent/index.ts +6 -6
  240. package/examples/extensions/summarize.ts +15 -4
  241. package/examples/extensions/todo.ts +0 -2
  242. package/examples/extensions/tools.ts +0 -5
  243. package/examples/extensions/trigger-compact.ts +11 -1
  244. package/examples/extensions/widget-placement.ts +4 -12
  245. package/examples/sdk/02-custom-model.ts +1 -1
  246. package/examples/sdk/09-api-keys-and-oauth.ts +3 -3
  247. package/examples/sdk/12-full-control.ts +1 -1
  248. package/examples/sdk/13-session-runtime.ts +67 -0
  249. package/examples/sdk/README.md +8 -5
  250. package/package.json +7 -8
  251. package/prompts/commands/atomic-commit.md +17 -0
  252. package/prompts/commands/discuss-phase.md +15 -0
  253. package/prompts/commands/execute-phase.md +14 -0
  254. package/prompts/commands/fix.md +14 -0
  255. package/prompts/commands/init-project.md +16 -0
  256. package/prompts/commands/map-codebase.md +16 -0
  257. package/prompts/commands/new-project.md +16 -0
  258. package/prompts/commands/next-milestone.md +16 -0
  259. package/prompts/commands/pause-work.md +13 -0
  260. package/prompts/commands/plan-phase.md +15 -0
  261. package/prompts/commands/progress.md +13 -0
  262. package/prompts/commands/quick.md +14 -0
  263. package/prompts/commands/resume-work.md +13 -0
  264. package/prompts/commands/review.md +15 -0
  265. package/prompts/commands/verify-work.md +15 -0
package/README.md CHANGED
@@ -1,15 +1,24 @@
1
- <h1 align="center">@draht/coding-agent</h1>
2
-
3
1
  <p align="center">
2
+ <a href="https://shittycodingagent.ai">
3
+ <img src="https://shittycodingagent.ai/logo.svg" alt="pi logo" width="128">
4
+ </a>
5
+ </p>
6
+ <p align="center">
7
+ <a href="https://discord.com/invite/3cU7Bz4UPx"><img alt="Discord" src="https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white" /></a>
4
8
  <a href="https://www.npmjs.com/package/@draht/coding-agent"><img alt="npm" src="https://img.shields.io/npm/v/@draht/coding-agent?style=flat-square" /></a>
5
9
  <a href="https://github.com/draht-dev/draht/actions/workflows/ci.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/draht-dev/draht/ci.yml?style=flat-square&branch=main" /></a>
6
10
  </p>
11
+ <p align="center">
12
+ <a href="https://pi.dev">pi.dev</a> domain graciously donated by
13
+ <br /><br />
14
+ <a href="https://exe.dev"><img src="docs/images/exy.png" alt="Exy mascot" width="48" /><br />exe.dev</a>
15
+ </p>
7
16
 
8
- Draht is a minimal terminal coding harness. Adapt it to your workflows, not the other way around, without having to fork and modify internals. Extend it with TypeScript [Extensions](#extensions), [Skills](#skills), [Prompt Templates](#prompt-templates), and [Themes](#themes). Put your extensions, skills, prompt templates, and themes in [Draht Packages](#draht-packages) and share them with others via npm or git.
17
+ Pi is a minimal terminal coding harness. Adapt pi to your workflows, not the other way around, without having to fork and modify pi internals. Extend it with TypeScript [Extensions](#extensions), [Skills](#skills), [Prompt Templates](#prompt-templates), and [Themes](#themes). Put your extensions, skills, prompt templates, and themes in [Pi Packages](#pi-packages) and share them with others via npm or git.
9
18
 
10
- Draht ships with powerful defaults but skips features like sub agents and plan mode. Instead, you can ask draht to build what you want or install a third party draht package that matches your workflow.
19
+ Pi ships with powerful defaults but skips features like sub agents and plan mode. Instead, you can ask pi to build what you want or install a third party pi package that matches your workflow.
11
20
 
12
- Draht runs in four modes: interactive, print or JSON, RPC for process integration, and an SDK for embedding in your own apps.
21
+ Pi runs in four modes: interactive, print or JSON, RPC for process integration, and an SDK for embedding in your own apps. See [openclaw/openclaw](https://github.com/openclaw/openclaw) for a real-world SDK integration.
13
22
 
14
23
  ## Table of Contents
15
24
 
@@ -30,7 +39,7 @@ Draht runs in four modes: interactive, print or JSON, RPC for process integratio
30
39
  - [Skills](#skills)
31
40
  - [Extensions](#extensions)
32
41
  - [Themes](#themes)
33
- - [Draht Packages](#draht-packages)
42
+ - [Pi Packages](#pi-packages)
34
43
  - [Programmatic Usage](#programmatic-usage)
35
44
  - [Philosophy](#philosophy)
36
45
  - [CLI Reference](#cli-reference)
@@ -40,24 +49,24 @@ Draht runs in four modes: interactive, print or JSON, RPC for process integratio
40
49
  ## Quick Start
41
50
 
42
51
  ```bash
43
- bun add -g @draht/coding-agent
52
+ npm install -g @draht/coding-agent
44
53
  ```
45
54
 
46
55
  Authenticate with an API key:
47
56
 
48
57
  ```bash
49
58
  export ANTHROPIC_API_KEY=sk-ant-...
50
- draht
59
+ pi
51
60
  ```
52
61
 
53
62
  Or use your existing subscription:
54
63
 
55
64
  ```bash
56
- draht
65
+ pi
57
66
  /login # Then select provider
58
67
  ```
59
68
 
60
- Then just talk to draht. By default, draht gives the model four tools: `read`, `write`, `edit`, and `bash`. The model uses these to fulfill your requests. Add capabilities via [skills](#skills), [prompt templates](#prompt-templates), [extensions](#extensions), or [draht packages](#draht-packages).
69
+ Then just talk to pi. By default, pi gives the model four tools: `read`, `write`, `edit`, and `bash`. The model uses these to fulfill your requests. Add capabilities via [skills](#skills), [prompt templates](#prompt-templates), [extensions](#extensions), or [pi packages](#pi-packages).
61
70
 
62
71
  **Platform notes:** [Windows](docs/windows.md) | [Termux (Android)](docs/termux.md) | [tmux](docs/tmux.md) | [Terminal setup](docs/terminal-setup.md) | [Shell aliases](docs/shell-aliases.md)
63
72
 
@@ -65,7 +74,7 @@ Then just talk to draht. By default, draht gives the model four tools: `read`, `
65
74
 
66
75
  ## Providers & Models
67
76
 
68
- For each built-in provider, draht maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L).
77
+ For each built-in provider, pi maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L).
69
78
 
70
79
  **Subscriptions:**
71
80
  - Anthropic Claude Pro/Max
@@ -96,7 +105,7 @@ For each built-in provider, draht maintains a list of tool-capable models, updat
96
105
 
97
106
  See [docs/providers.md](docs/providers.md) for detailed setup instructions.
98
107
 
99
- **Custom providers & models:** Add providers via `~/.draht/agent/models.json` if they speak a supported API (OpenAI, Anthropic, Google). For custom APIs or OAuth, use extensions. See [docs/models.md](docs/models.md) and [docs/custom-provider.md](docs/custom-provider.md).
108
+ **Custom providers & models:** Add providers via `~/.pi/agent/models.json` if they speak a supported API (OpenAI, Anthropic, Google). For custom APIs or OAuth, use extensions. See [docs/models.md](docs/models.md) and [docs/custom-provider.md](docs/custom-provider.md).
100
109
 
101
110
  ---
102
111
 
@@ -148,11 +157,11 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist
148
157
  | `/reload` | Reload keybindings, extensions, skills, prompts, and context files (themes hot-reload automatically) |
149
158
  | `/hotkeys` | Show all keyboard shortcuts |
150
159
  | `/changelog` | Display version history |
151
- | `/quit`, `/exit` | Quit draht |
160
+ | `/quit` | Quit pi |
152
161
 
153
162
  ### Keyboard Shortcuts
154
163
 
155
- See `/hotkeys` for the full list. Customize via `~/.draht/agent/keybindings.json`. See [docs/keybindings.md](docs/keybindings.md).
164
+ See `/hotkeys` for the full list. Customize via `~/.pi/agent/keybindings.json`. See [docs/keybindings.md](docs/keybindings.md).
156
165
 
157
166
  **Commonly used:**
158
167
 
@@ -177,7 +186,7 @@ Submit messages while the agent is working:
177
186
  - **Escape** aborts and restores queued messages to editor
178
187
  - **Alt+Up** retrieves queued messages back to editor
179
188
 
180
- On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so draht can receive the follow-up shortcut.
189
+ On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so pi can receive the follow-up shortcut.
181
190
 
182
191
  Configure delivery in [settings](docs/settings.md): `steeringMode` and `followUpMode` can be `"one-at-a-time"` (default, waits for response) or `"all"` (delivers all queued at once). `transport` selects provider transport preference (`"sse"`, `"websocket"`, or `"auto"`) for providers that support multiple transports.
183
192
 
@@ -189,14 +198,14 @@ Sessions are stored as JSONL files with a tree structure. Each entry has an `id`
189
198
 
190
199
  ### Management
191
200
 
192
- Sessions auto-save to `~/.draht/agent/sessions/` organized by working directory.
201
+ Sessions auto-save to `~/.pi/agent/sessions/` organized by working directory.
193
202
 
194
203
  ```bash
195
- draht -c # Continue most recent session
196
- draht -r # Browse and select from past sessions
197
- draht --no-session # Ephemeral mode (don't save)
198
- draht --session <path> # Use specific session file or ID
199
- draht --fork <path> # Fork specific session file or ID into a new session
204
+ pi -c # Continue most recent session
205
+ pi -r # Browse and select from past sessions
206
+ pi --no-session # Ephemeral mode (don't save)
207
+ pi --session <path> # Use specific session file or ID
208
+ pi --fork <path> # Fork specific session file or ID into a new session
200
209
  ```
201
210
 
202
211
  ### Branching
@@ -207,7 +216,7 @@ draht --fork <path> # Fork specific session file or ID into a new session
207
216
 
208
217
  - Search by typing, fold/unfold and jump between branches with Ctrl+←/Ctrl+→ or Alt+←/Alt+→, page with ←/→
209
218
  - Filter modes (Ctrl+O): default → no-tools → user-only → labeled-only → all
210
- - Press `l` to label entries as bookmarks
219
+ - Press Shift+L to label entries as bookmarks and Shift+T to toggle label timestamps
211
220
 
212
221
  **`/fork`** - Create a new session file from the current branch. Opens a selector, copies history up to the selected point, and places that message in the editor for modification.
213
222
 
@@ -231,8 +240,8 @@ Use `/settings` to modify common options, or edit JSON files directly:
231
240
 
232
241
  | Location | Scope |
233
242
  |----------|-------|
234
- | `~/.draht/agent/settings.json` | Global (all projects) |
235
- | `.draht/settings.json` | Project (overrides global) |
243
+ | `~/.pi/agent/settings.json` | Global (all projects) |
244
+ | `.pi/settings.json` | Project (overrides global) |
236
245
 
237
246
  See [docs/settings.md](docs/settings.md) for all options.
238
247
 
@@ -240,8 +249,8 @@ See [docs/settings.md](docs/settings.md) for all options.
240
249
 
241
250
  ## Context Files
242
251
 
243
- Draht loads `AGENTS.md` (or `CLAUDE.md`) at startup from:
244
- - `~/.draht/agent/AGENTS.md` (global)
252
+ Pi loads `AGENTS.md` (or `CLAUDE.md`) at startup from:
253
+ - `~/.pi/agent/AGENTS.md` (global)
245
254
  - Parent directories (walking up from cwd)
246
255
  - Current directory
247
256
 
@@ -249,7 +258,7 @@ Use for project instructions, conventions, common commands. All matching files a
249
258
 
250
259
  ### System Prompt
251
260
 
252
- Replace the default system prompt with `.draht/SYSTEM.md` (project) or `~/.draht/agent/SYSTEM.md` (global). Append without replacing via `APPEND_SYSTEM.md`.
261
+ Replace the default system prompt with `.pi/SYSTEM.md` (project) or `~/.pi/agent/SYSTEM.md` (global). Append without replacing via `APPEND_SYSTEM.md`.
253
262
 
254
263
  ---
255
264
 
@@ -260,19 +269,19 @@ Replace the default system prompt with `.draht/SYSTEM.md` (project) or `~/.draht
260
269
  Reusable prompts as Markdown files. Type `/name` to expand.
261
270
 
262
271
  ```markdown
263
- <!-- ~/.draht/agent/prompts/review.md -->
272
+ <!-- ~/.pi/agent/prompts/review.md -->
264
273
  Review this code for bugs, security issues, and performance problems.
265
274
  Focus on: {{focus}}
266
275
  ```
267
276
 
268
- Place in `~/.draht/agent/prompts/`, `.draht/prompts/`, or a [draht package](#draht-packages) to share with others. See [docs/prompt-templates.md](docs/prompt-templates.md).
277
+ Place in `~/.pi/agent/prompts/`, `.pi/prompts/`, or a [pi package](#pi-packages) to share with others. See [docs/prompt-templates.md](docs/prompt-templates.md).
269
278
 
270
279
  ### Skills
271
280
 
272
281
  On-demand capability packages following the [Agent Skills standard](https://agentskills.io). Invoke via `/skill:name` or let the agent load them automatically.
273
282
 
274
283
  ```markdown
275
- <!-- ~/.draht/agent/skills/my-skill/SKILL.md -->
284
+ <!-- ~/.pi/agent/skills/my-skill/SKILL.md -->
276
285
  # My Skill
277
286
  Use this skill when the user asks about X.
278
287
 
@@ -281,19 +290,19 @@ Use this skill when the user asks about X.
281
290
  2. Then that
282
291
  ```
283
292
 
284
- Place in `~/.draht/agent/skills/`, `~/.agents/skills/`, `.draht/skills/`, or `.agents/skills/` (from `cwd` up through parent directories) or a [draht package](#draht-packages) to share with others. See [docs/skills.md](docs/skills.md).
293
+ Place in `~/.pi/agent/skills/`, `~/.agents/skills/`, `.pi/skills/`, or `.agents/skills/` (from `cwd` up through parent directories) or a [pi package](#pi-packages) to share with others. See [docs/skills.md](docs/skills.md).
285
294
 
286
295
  ### Extensions
287
296
 
288
297
  <p align="center"><img src="docs/images/doom-extension.png" alt="Doom Extension" width="600"></p>
289
298
 
290
- TypeScript modules that extend draht with custom tools, commands, keyboard shortcuts, event handlers, and UI components.
299
+ TypeScript modules that extend pi with custom tools, commands, keyboard shortcuts, event handlers, and UI components.
291
300
 
292
301
  ```typescript
293
- export default function (draht: ExtensionAPI) {
294
- draht.registerTool({ name: "deploy", ... });
295
- draht.registerCommand("stats", { ... });
296
- draht.on("tool_call", async (event, ctx) => { ... });
302
+ export default function (pi: ExtensionAPI) {
303
+ pi.registerTool({ name: "deploy", ... });
304
+ pi.registerCommand("stats", { ... });
305
+ pi.on("tool_call", async (event, ctx) => { ... });
297
306
  }
298
307
  ```
299
308
 
@@ -307,50 +316,50 @@ export default function (draht: ExtensionAPI) {
307
316
  - Git checkpointing and auto-commit
308
317
  - SSH and sandbox execution
309
318
  - MCP server integration
310
- - Make draht look like Claude Code
319
+ - Make pi look like Claude Code
311
320
  - Games while waiting (yes, Doom runs)
312
321
  - ...anything you can dream up
313
322
 
314
- Place in `~/.draht/agent/extensions/`, `.draht/extensions/`, or a [draht package](#draht-packages) to share with others. See [docs/extensions.md](docs/extensions.md) and [examples/extensions/](examples/extensions/).
323
+ Place in `~/.pi/agent/extensions/`, `.pi/extensions/`, or a [pi package](#pi-packages) to share with others. See [docs/extensions.md](docs/extensions.md) and [examples/extensions/](examples/extensions/).
315
324
 
316
325
  ### Themes
317
326
 
318
- Built-in: `dark`, `light`. Themes hot-reload: modify the active theme file and draht immediately applies changes.
327
+ Built-in: `dark`, `light`. Themes hot-reload: modify the active theme file and pi immediately applies changes.
319
328
 
320
- Place in `~/.draht/agent/themes/`, `.draht/themes/`, or a [draht package](#draht-packages) to share with others. See [docs/themes.md](docs/themes.md).
329
+ Place in `~/.pi/agent/themes/`, `.pi/themes/`, or a [pi package](#pi-packages) to share with others. See [docs/themes.md](docs/themes.md).
321
330
 
322
- ### Draht Packages
331
+ ### Pi Packages
323
332
 
324
- Bundle and share extensions, skills, prompts, and themes via npm or git. Find packages on [npmjs.com](https://www.npmjs.com/search?q=keywords%3Adraht-package) or [Discord](https://discord.com/channels/1456806362351669492/1457744485428629628).
333
+ Bundle and share extensions, skills, prompts, and themes via npm or git. Find packages on [npmjs.com](https://www.npmjs.com/search?q=keywords%3Api-package) or [Discord](https://discord.com/channels/1456806362351669492/1457744485428629628).
325
334
 
326
- > **Security:** Draht packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
335
+ > **Security:** Pi packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
327
336
 
328
337
  ```bash
329
- draht install npm:@foo/draht-tools
330
- draht install npm:@foo/draht-tools@1.2.3 # pinned version
331
- draht install git:github.com/user/repo
332
- draht install git:github.com/user/repo@v1 # tag or commit
333
- draht install git:git@github.com:user/repo
334
- draht install git:git@github.com:user/repo@v1 # tag or commit
335
- draht install https://github.com/user/repo
336
- draht install https://github.com/user/repo@v1 # tag or commit
337
- draht install ssh://git@github.com/user/repo
338
- draht install ssh://git@github.com/user/repo@v1 # tag or commit
339
- draht remove npm:@foo/draht-tools
340
- draht uninstall npm:@foo/draht-tools # alias for remove
341
- draht list
342
- draht update # skips pinned packages
343
- draht config # enable/disable extensions, skills, prompts, themes
338
+ pi install npm:@foo/pi-tools
339
+ pi install npm:@foo/pi-tools@1.2.3 # pinned version
340
+ pi install git:github.com/user/repo
341
+ pi install git:github.com/user/repo@v1 # tag or commit
342
+ pi install git:git@github.com:user/repo
343
+ pi install git:git@github.com:user/repo@v1 # tag or commit
344
+ pi install https://github.com/user/repo
345
+ pi install https://github.com/user/repo@v1 # tag or commit
346
+ pi install ssh://git@github.com/user/repo
347
+ pi install ssh://git@github.com/user/repo@v1 # tag or commit
348
+ pi remove npm:@foo/pi-tools
349
+ pi uninstall npm:@foo/pi-tools # alias for remove
350
+ pi list
351
+ pi update # skips pinned packages
352
+ pi config # enable/disable extensions, skills, prompts, themes
344
353
  ```
345
354
 
346
- Packages install to `~/.draht/agent/git/` (git) or global npm. Use `-l` for project-local installs (`.draht/git/`, `.draht/npm/`). If you use a Node version manager and want package installs to reuse a stable npm context, set `npmCommand` in `settings.json`, for example `["mise", "exec", "node@20", "--", "npm"]`.
355
+ Packages install to `~/.pi/agent/git/` (git) or global npm. Use `-l` for project-local installs (`.pi/git/`, `.pi/npm/`). If you use a Node version manager and want package installs to reuse a stable npm context, set `npmCommand` in `settings.json`, for example `["mise", "exec", "node@20", "--", "npm"]`.
347
356
 
348
- Create a package by adding a `draht` key to `package.json`:
357
+ Create a package by adding a `pi` key to `package.json`:
349
358
 
350
359
  ```json
351
360
  {
352
- "name": "my-draht-package",
353
- "keywords": ["draht-package"],
361
+ "name": "my-pi-package",
362
+ "keywords": ["pi-package"],
354
363
  "draht": {
355
364
  "extensions": ["./extensions"],
356
365
  "skills": ["./skills"],
@@ -360,7 +369,7 @@ Create a package by adding a `draht` key to `package.json`:
360
369
  }
361
370
  ```
362
371
 
363
- Without a `draht` manifest, pi auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`).
372
+ Without a `pi` manifest, pi auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`).
364
373
 
365
374
  See [docs/packages.md](docs/packages.md).
366
375
 
@@ -373,15 +382,19 @@ See [docs/packages.md](docs/packages.md).
373
382
  ```typescript
374
383
  import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@draht/coding-agent";
375
384
 
385
+ const authStorage = AuthStorage.create();
386
+ const modelRegistry = ModelRegistry.create(authStorage);
376
387
  const { session } = await createAgentSession({
377
388
  sessionManager: SessionManager.inMemory(),
378
- authStorage: AuthStorage.create(),
379
- modelRegistry: new ModelRegistry(authStorage),
389
+ authStorage,
390
+ modelRegistry,
380
391
  });
381
392
 
382
393
  await session.prompt("What files are in the current directory?");
383
394
  ```
384
395
 
396
+ For advanced multi-session runtime replacement, use `createAgentSessionRuntime()` and `AgentSessionRuntime`.
397
+
385
398
  See [docs/sdk.md](docs/sdk.md) and [examples/sdk/](examples/sdk/).
386
399
 
387
400
  ### RPC Mode
@@ -389,7 +402,7 @@ See [docs/sdk.md](docs/sdk.md) and [examples/sdk/](examples/sdk/).
389
402
  For non-Node.js integrations, use RPC mode over stdin/stdout:
390
403
 
391
404
  ```bash
392
- draht --mode rpc
405
+ pi --mode rpc
393
406
  ```
394
407
 
395
408
  RPC mode uses strict LF-delimited JSONL framing. Clients must split records on `\n` only. Do not use generic line readers like Node `readline`, which also split on Unicode separators inside JSON payloads.
@@ -400,11 +413,11 @@ See [docs/rpc.md](docs/rpc.md) for the protocol.
400
413
 
401
414
  ## Philosophy
402
415
 
403
- Draht is aggressively extensible so it doesn't have to dictate your workflow. Features that other tools bake in can be built with [extensions](#extensions), [skills](#skills), or installed from third-party [draht packages](#draht-packages). This keeps the core minimal while letting you shape draht to fit how you work.
416
+ Pi is aggressively extensible so it doesn't have to dictate your workflow. Features that other tools bake in can be built with [extensions](#extensions), [skills](#skills), or installed from third-party [pi packages](#pi-packages). This keeps the core minimal while letting you shape pi to fit how you work.
404
417
 
405
- **No MCP.** Build CLI tools with READMEs (see [Skills](#skills)), or build an extension that adds MCP support.
418
+ **No MCP.** Build CLI tools with READMEs (see [Skills](#skills)), or build an extension that adds MCP support. [Why?](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/)
406
419
 
407
- **No sub-agents.** There's many ways to do this. Spawn draht instances via tmux, or build your own with [extensions](#extensions), or install a package that does it your way.
420
+ **No sub-agents.** There's many ways to do this. Spawn pi instances via tmux, or build your own with [extensions](#extensions), or install a package that does it your way.
408
421
 
409
422
  **No permission popups.** Run in a container, or build your own confirmation flow with [extensions](#extensions) inline with your environment and security requirements.
410
423
 
@@ -414,25 +427,25 @@ Draht is aggressively extensible so it doesn't have to dictate your workflow. Fe
414
427
 
415
428
  **No background bash.** Use tmux. Full observability, direct interaction.
416
429
 
417
-
430
+ Read the [blog post](https://mariozechner.at/posts/2025-11-30-draht-coding-agent/) for the full rationale.
418
431
 
419
432
  ---
420
433
 
421
434
  ## CLI Reference
422
435
 
423
436
  ```bash
424
- draht [options] [@files...] [messages...]
437
+ pi [options] [@files...] [messages...]
425
438
  ```
426
439
 
427
440
  ### Package Commands
428
441
 
429
442
  ```bash
430
- draht install <source> [-l] # Install package, -l for project-local
431
- draht remove <source> [-l] # Remove package
432
- draht uninstall <source> [-l] # Alias for remove
433
- draht update [source] # Update packages (skips pinned)
434
- draht list # List installed packages
435
- draht config # Enable/disable package resources
443
+ pi install <source> [-l] # Install package, -l for project-local
444
+ pi remove <source> [-l] # Remove package
445
+ pi uninstall <source> [-l] # Alias for remove
446
+ pi update [source] # Update packages (skips pinned)
447
+ pi list # List installed packages
448
+ pi config # Enable/disable package resources
436
449
  ```
437
450
 
438
451
  ### Modes
@@ -448,7 +461,7 @@ draht config # Enable/disable package resources
448
461
  In print mode, pi also reads piped stdin and merges it into the initial prompt:
449
462
 
450
463
  ```bash
451
- cat README.md | draht -p "Summarize this text"
464
+ cat README.md | pi -p "Summarize this text"
452
465
  ```
453
466
 
454
467
  ### Model Options
@@ -512,50 +525,50 @@ Combine `--no-*` with explicit flags to load exactly what you need, ignoring set
512
525
  Prefix files with `@` to include in the message:
513
526
 
514
527
  ```bash
515
- draht @prompt.md "Answer this"
516
- draht -p @screenshot.png "What's in this image?"
517
- draht @code.ts @test.ts "Review these files"
528
+ pi @prompt.md "Answer this"
529
+ pi -p @screenshot.png "What's in this image?"
530
+ pi @code.ts @test.ts "Review these files"
518
531
  ```
519
532
 
520
533
  ### Examples
521
534
 
522
535
  ```bash
523
536
  # Interactive with initial prompt
524
- draht "List all .ts files in src/"
537
+ pi "List all .ts files in src/"
525
538
 
526
539
  # Non-interactive
527
- draht -p "Summarize this codebase"
540
+ pi -p "Summarize this codebase"
528
541
 
529
542
  # Non-interactive with piped stdin
530
- cat README.md | draht -p "Summarize this text"
543
+ cat README.md | pi -p "Summarize this text"
531
544
 
532
545
  # Different model
533
- draht --provider openai --model gpt-4o "Help me refactor"
546
+ pi --provider openai --model gpt-4o "Help me refactor"
534
547
 
535
548
  # Model with provider prefix (no --provider needed)
536
- draht --model openai/gpt-4o "Help me refactor"
549
+ pi --model openai/gpt-4o "Help me refactor"
537
550
 
538
551
  # Model with thinking level shorthand
539
- draht --model sonnet:high "Solve this complex problem"
552
+ pi --model sonnet:high "Solve this complex problem"
540
553
 
541
554
  # Limit model cycling
542
- draht --models "claude-*,gpt-4o"
555
+ pi --models "claude-*,gpt-4o"
543
556
 
544
557
  # Read-only mode
545
- draht --tools read,grep,find,ls -p "Review the code"
558
+ pi --tools read,grep,find,ls -p "Review the code"
546
559
 
547
560
  # High thinking level
548
- draht --thinking high "Solve this complex problem"
561
+ pi --thinking high "Solve this complex problem"
549
562
  ```
550
563
 
551
564
  ### Environment Variables
552
565
 
553
566
  | Variable | Description |
554
567
  |----------|-------------|
555
- | `DRAHT_CODING_AGENT_DIR` | Override config directory (default: `~/.draht/agent`) |
556
- | `DRAHT_PACKAGE_DIR` | Override package directory (useful for Nix/Guix where store paths tokenize poorly) |
557
- | `DRAHT_SKIP_VERSION_CHECK` | Skip version check at startup |
558
- | `DRAHT_CACHE_RETENTION` | Set to `long` for extended prompt cache (Anthropic: 1h, OpenAI: 24h) |
568
+ | `PI_CODING_AGENT_DIR` | Override config directory (default: `~/.pi/agent`) |
569
+ | `PI_PACKAGE_DIR` | Override package directory (useful for Nix/Guix where store paths tokenize poorly) |
570
+ | `PI_SKIP_VERSION_CHECK` | Skip version check at startup |
571
+ | `PI_CACHE_RETENTION` | Set to `long` for extended prompt cache (Anthropic: 1h, OpenAI: 24h) |
559
572
  | `VISUAL`, `EDITOR` | External editor for Ctrl+G |
560
573
 
561
574
  ---
@@ -572,6 +585,6 @@ MIT
572
585
 
573
586
  ## See Also
574
587
 
575
- - [@draht/ai](../ai): Core LLM toolkit
576
- - [@draht/agent-core](../agent): Agent framework
577
- - [@draht/tui](../tui): Terminal UI components
588
+ - [@draht/ai](https://www.npmjs.com/package/@draht/ai): Core LLM toolkit
589
+ - [@draht/coding-agent-agent](https://www.npmjs.com/package/@draht/coding-agent-agent): Agent framework
590
+ - [@draht/tui](https://www.npmjs.com/package/@draht/tui): Terminal UI components
@@ -2,6 +2,7 @@
2
2
  * CLI argument parsing and help display
3
3
  */
4
4
  import type { ThinkingLevel } from "@draht/agent-core";
5
+ import type { ExtensionFlag } from "../core/extensions/types.js";
5
6
  import { type ToolName } from "../core/tools/index.js";
6
7
  export type Mode = "text" | "json" | "rpc";
7
8
  export interface Args {
@@ -36,20 +37,16 @@ export interface Args {
36
37
  listModels?: string | true;
37
38
  offline?: boolean;
38
39
  verbose?: boolean;
39
- /** Experimental: Start session with socket server for multi-attach */
40
- attachable?: boolean;
41
- /** Experimental: Attach to an existing socket session */
42
- attach?: string;
43
- /** Experimental: List all attachable socket sessions */
44
- listSessions?: boolean;
45
40
  messages: string[];
46
41
  fileArgs: string[];
47
42
  /** Unknown flags (potentially extension flags) - map of flag name to value */
48
43
  unknownFlags: Map<string, boolean | string>;
44
+ diagnostics: Array<{
45
+ type: "warning" | "error";
46
+ message: string;
47
+ }>;
49
48
  }
50
49
  export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
51
- export declare function parseArgs(args: string[], extensionFlags?: Map<string, {
52
- type: "boolean" | "string";
53
- }>): Args;
54
- export declare function printHelp(): void;
50
+ export declare function parseArgs(args: string[]): Args;
51
+ export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
55
52
  //# sourceMappingURL=args.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;CAC5C;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CAkI5G;AAED,wBAAgB,SAAS,IAAI,IAAI,CA0JhC","sourcesContent":["/**\n * CLI argument parsing and help display\n */\n\nimport type { ThinkingLevel } from \"@draht/agent-core\";\nimport chalk from \"chalk\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from \"../config.js\";\nimport { allTools, type ToolName } from \"../core/tools/index.js\";\n\nexport type Mode = \"text\" | \"json\" | \"rpc\";\n\nexport interface Args {\n\tprovider?: string;\n\tmodel?: string;\n\tapiKey?: string;\n\tsystemPrompt?: string;\n\tappendSystemPrompt?: string;\n\tthinking?: ThinkingLevel;\n\tcontinue?: boolean;\n\tresume?: boolean;\n\thelp?: boolean;\n\tversion?: boolean;\n\tmode?: Mode;\n\tnoSession?: boolean;\n\tsession?: string;\n\tfork?: string;\n\tsessionDir?: string;\n\tmodels?: string[];\n\ttools?: ToolName[];\n\tnoTools?: boolean;\n\textensions?: string[];\n\tnoExtensions?: boolean;\n\tprint?: boolean;\n\texport?: string;\n\tnoSkills?: boolean;\n\tskills?: string[];\n\tpromptTemplates?: string[];\n\tnoPromptTemplates?: boolean;\n\tthemes?: string[];\n\tnoThemes?: boolean;\n\tlistModels?: string | true;\n\toffline?: boolean;\n\tverbose?: boolean;\n\t/** Experimental: Start session with socket server for multi-attach */\n\tattachable?: boolean;\n\t/** Experimental: Attach to an existing socket session */\n\tattach?: string;\n\t/** Experimental: List all attachable socket sessions */\n\tlistSessions?: boolean;\n\tmessages: string[];\n\tfileArgs: string[];\n\t/** Unknown flags (potentially extension flags) - map of flag name to value */\n\tunknownFlags: Map<string, boolean | string>;\n}\n\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\n\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\n}\n\nexport function parseArgs(args: string[], extensionFlags?: Map<string, { type: \"boolean\" | \"string\" }>): Args {\n\tconst result: Args = {\n\t\tmessages: [],\n\t\tfileArgs: [],\n\t\tunknownFlags: new Map(),\n\t};\n\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\tresult.help = true;\n\t\t} else if (arg === \"--version\" || arg === \"-v\") {\n\t\t\tresult.version = true;\n\t\t} else if (arg === \"--mode\" && i + 1 < args.length) {\n\t\t\tconst mode = args[++i];\n\t\t\tif (mode === \"text\" || mode === \"json\" || mode === \"rpc\") {\n\t\t\t\tresult.mode = mode;\n\t\t\t}\n\t\t} else if (arg === \"--continue\" || arg === \"-c\") {\n\t\t\tresult.continue = true;\n\t\t} else if (arg === \"--resume\" || arg === \"-r\") {\n\t\t\tresult.resume = true;\n\t\t} else if (arg === \"--provider\" && i + 1 < args.length) {\n\t\t\tresult.provider = args[++i];\n\t\t} else if (arg === \"--model\" && i + 1 < args.length) {\n\t\t\tresult.model = args[++i];\n\t\t} else if (arg === \"--api-key\" && i + 1 < args.length) {\n\t\t\tresult.apiKey = args[++i];\n\t\t} else if (arg === \"--system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.systemPrompt = args[++i];\n\t\t} else if (arg === \"--append-system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.appendSystemPrompt = args[++i];\n\t\t} else if (arg === \"--no-session\") {\n\t\t\tresult.noSession = true;\n\t\t} else if (arg === \"--session\" && i + 1 < args.length) {\n\t\t\tresult.session = args[++i];\n\t\t} else if (arg === \"--fork\" && i + 1 < args.length) {\n\t\t\tresult.fork = args[++i];\n\t\t} else if (arg === \"--session-dir\" && i + 1 < args.length) {\n\t\t\tresult.sessionDir = args[++i];\n\t\t} else if (arg === \"--models\" && i + 1 < args.length) {\n\t\t\tresult.models = args[++i].split(\",\").map((s) => s.trim());\n\t\t} else if (arg === \"--no-tools\") {\n\t\t\tresult.noTools = true;\n\t\t} else if (arg === \"--tools\" && i + 1 < args.length) {\n\t\t\tconst toolNames = args[++i].split(\",\").map((s) => s.trim());\n\t\t\tconst validTools: ToolName[] = [];\n\t\t\tfor (const name of toolNames) {\n\t\t\t\tif (name in allTools) {\n\t\t\t\t\tvalidTools.push(name as ToolName);\n\t\t\t\t} else {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\tchalk.yellow(`Warning: Unknown tool \"${name}\". Valid tools: ${Object.keys(allTools).join(\", \")}`),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t\tresult.tools = validTools;\n\t\t} else if (arg === \"--thinking\" && i + 1 < args.length) {\n\t\t\tconst level = args[++i];\n\t\t\tif (isValidThinkingLevel(level)) {\n\t\t\t\tresult.thinking = level;\n\t\t\t} else {\n\t\t\t\tconsole.error(\n\t\t\t\t\tchalk.yellow(\n\t\t\t\t\t\t`Warning: Invalid thinking level \"${level}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t} else if (arg === \"--print\" || arg === \"-p\") {\n\t\t\tresult.print = true;\n\t\t} else if (arg === \"--export\" && i + 1 < args.length) {\n\t\t\tresult.export = args[++i];\n\t\t} else if ((arg === \"--extension\" || arg === \"-e\") && i + 1 < args.length) {\n\t\t\tresult.extensions = result.extensions ?? [];\n\t\t\tresult.extensions.push(args[++i]);\n\t\t} else if (arg === \"--no-extensions\" || arg === \"-ne\") {\n\t\t\tresult.noExtensions = true;\n\t\t} else if (arg === \"--skill\" && i + 1 < args.length) {\n\t\t\tresult.skills = result.skills ?? [];\n\t\t\tresult.skills.push(args[++i]);\n\t\t} else if (arg === \"--prompt-template\" && i + 1 < args.length) {\n\t\t\tresult.promptTemplates = result.promptTemplates ?? [];\n\t\t\tresult.promptTemplates.push(args[++i]);\n\t\t} else if (arg === \"--theme\" && i + 1 < args.length) {\n\t\t\tresult.themes = result.themes ?? [];\n\t\t\tresult.themes.push(args[++i]);\n\t\t} else if (arg === \"--no-skills\" || arg === \"-ns\") {\n\t\t\tresult.noSkills = true;\n\t\t} else if (arg === \"--no-prompt-templates\" || arg === \"-np\") {\n\t\t\tresult.noPromptTemplates = true;\n\t\t} else if (arg === \"--no-themes\") {\n\t\t\tresult.noThemes = true;\n\t\t} else if (arg === \"--list-models\") {\n\t\t\t// Check if next arg is a search pattern (not a flag or file arg)\n\t\t\tif (i + 1 < args.length && !args[i + 1].startsWith(\"-\") && !args[i + 1].startsWith(\"@\")) {\n\t\t\t\tresult.listModels = args[++i];\n\t\t\t} else {\n\t\t\t\tresult.listModels = true;\n\t\t\t}\n\t\t} else if (arg === \"--verbose\") {\n\t\t\tresult.verbose = true;\n\t\t} else if (arg === \"--offline\") {\n\t\t\tresult.offline = true;\n\t\t} else if (arg === \"--attachable\") {\n\t\t\tresult.attachable = true;\n\t\t} else if (arg === \"--attach\" && i + 1 < args.length) {\n\t\t\tresult.attach = args[++i];\n\t\t} else if (arg === \"--list-sessions\") {\n\t\t\tresult.listSessions = true;\n\t\t} else if (arg.startsWith(\"@\")) {\n\t\t\tresult.fileArgs.push(arg.slice(1)); // Remove @ prefix\n\t\t} else if (arg.startsWith(\"--\") && extensionFlags) {\n\t\t\t// Check if it's an extension-registered flag\n\t\t\tconst flagName = arg.slice(2);\n\t\t\tconst extFlag = extensionFlags.get(flagName);\n\t\t\tif (extFlag) {\n\t\t\t\tif (extFlag.type === \"boolean\") {\n\t\t\t\t\tresult.unknownFlags.set(flagName, true);\n\t\t\t\t} else if (extFlag.type === \"string\" && i + 1 < args.length) {\n\t\t\t\t\tresult.unknownFlags.set(flagName, args[++i]);\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Unknown flags without extensionFlags are silently ignored (first pass)\n\t\t} else if (!arg.startsWith(\"-\")) {\n\t\t\tresult.messages.push(arg);\n\t\t}\n\t}\n\n\treturn result;\n}\n\nexport function printHelp(): void {\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n ${APP_NAME} [options] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n ${APP_NAME} install <source> [-l] Install extension source and add to settings\n ${APP_NAME} remove <source> [-l] Remove extension source from settings\n ${APP_NAME} uninstall <source> [-l] Alias for remove\n ${APP_NAME} update [source] Update installed extensions (skips pinned sources)\n ${APP_NAME} list List installed extensions from settings\n ${APP_NAME} config Open TUI to enable/disable package resources\n ${APP_NAME} <command> --help Show help for install/remove/uninstall/update/list\n\n${chalk.bold(\"Options:\")}\n --provider <name> Provider name (default: google)\n --model <pattern> Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n --api-key <key> API key (defaults to env vars)\n --system-prompt <text> System prompt (default: coding assistant prompt)\n --append-system-prompt <text> Append text or file contents to the system prompt\n --mode <mode> Output mode: text (default), json, or rpc\n --print, -p Non-interactive mode: process prompt and exit\n --continue, -c Continue previous session\n --resume, -r Select a session to resume\n --session <path> Use specific session file\n --fork <path> Fork specific session file or partial UUID into a new session\n --session-dir <dir> Directory for session storage and lookup\n --no-session Don't save session (ephemeral)\n --models <patterns> Comma-separated model patterns for Ctrl+P cycling\n Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n --no-tools Disable all built-in tools\n --tools <tools> Comma-separated list of tools to enable (default: read,bash,edit,write)\n Available: read, bash, edit, write, grep, find, ls\n --thinking <level> Set thinking level: off, minimal, low, medium, high, xhigh\n --extension, -e <path> Load an extension file (can be used multiple times)\n --no-extensions, -ne Disable extension discovery (explicit -e paths still work)\n --skill <path> Load a skill file or directory (can be used multiple times)\n --no-skills, -ns Disable skills discovery and loading\n --prompt-template <path> Load a prompt template file or directory (can be used multiple times)\n --no-prompt-templates, -np Disable prompt template discovery and loading\n --theme <path> Load a theme file or directory (can be used multiple times)\n --no-themes Disable theme discovery and loading\n --export <file> Export session file to HTML and exit\n --list-models [search] List available models (with optional fuzzy search)\n --verbose Force verbose startup (overrides quietStartup setting)\n --offline Disable startup network operations (same as DRAHT_OFFLINE=1)\n --help, -h Show this help\n --version, -v Show version number\n\n${chalk.bold(\"Experimental - Attachable Sessions (tmux-style multi-attach):\")}\n --attachable Start session with socket server for multi-client attachment\n --attach <session-id> Attach to an existing socket-based session\n --list-sessions List all running attachable sessions\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).\n\n${chalk.bold(\"Examples:\")}\n # Interactive mode\n ${APP_NAME}\n\n # Interactive mode with initial prompt\n ${APP_NAME} \"List all .ts files in src/\"\n\n # Include files in initial message\n ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n # Non-interactive mode (process and exit)\n ${APP_NAME} -p \"List all .ts files in src/\"\n\n # Multiple messages (interactive)\n ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n # Continue previous session\n ${APP_NAME} --continue \"What did we discuss?\"\n\n # Use different model\n ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n # Use model with provider prefix (no --provider needed)\n ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n # Use model with thinking level shorthand\n ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n # Limit model cycling to specific models\n ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n # Limit to a specific provider with glob pattern\n ${APP_NAME} --models \"github-copilot/*\"\n\n # Cycle models with fixed thinking levels\n ${APP_NAME} --models sonnet:high,haiku:low\n\n # Start with a specific thinking level\n ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n # Read-only mode (no file modifications possible)\n ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n # Export a session file to HTML\n ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n ${APP_NAME} --export session.jsonl output.html\n\n # ${chalk.bold(\"Experimental - Attachable Sessions\")}\n # Start an attachable session (others can attach via --attach)\n ${APP_NAME} --attachable \"Build a new feature\"\n\n # List all running attachable sessions\n ${APP_NAME} --list-sessions\n\n # Attach to a running session (tmux-style surveillance)\n ${APP_NAME} --attach abc-123-session-id\n\n${chalk.bold(\"Environment Variables:\")}\n ANTHROPIC_API_KEY - Anthropic Claude API key\n ANTHROPIC_OAUTH_TOKEN - Anthropic OAuth token (alternative to API key)\n OPENAI_API_KEY - OpenAI GPT API key\n AZURE_OPENAI_API_KEY - Azure OpenAI API key\n AZURE_OPENAI_BASE_URL - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)\n AZURE_OPENAI_RESOURCE_NAME - Azure OpenAI resource name (alternative to base URL)\n AZURE_OPENAI_API_VERSION - Azure OpenAI API version (default: v1)\n AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n GEMINI_API_KEY - Google Gemini API key\n GROQ_API_KEY - Groq API key\n CEREBRAS_API_KEY - Cerebras API key\n XAI_API_KEY - xAI Grok API key\n OPENROUTER_API_KEY - OpenRouter API key\n AI_GATEWAY_API_KEY - Vercel AI Gateway API key\n ZAI_API_KEY - ZAI API key\n MISTRAL_API_KEY - Mistral API key\n MINIMAX_API_KEY - MiniMax API key\n OPENCODE_API_KEY - OpenCode Zen/OpenCode Go API key\n KIMI_API_KEY - Kimi For Coding API key\n AWS_PROFILE - AWS profile for Amazon Bedrock\n AWS_ACCESS_KEY_ID - AWS access key for Amazon Bedrock\n AWS_SECRET_ACCESS_KEY - AWS secret key for Amazon Bedrock\n AWS_BEARER_TOKEN_BEDROCK - Bedrock API key (bearer token)\n AWS_REGION - AWS region for Amazon Bedrock (e.g., us-east-1)\n ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)\n DRAHT_PACKAGE_DIR - Override package directory (for Nix/Guix store paths)\n DRAHT_OFFLINE - Disable startup network operations when set to 1/true/yes\n DRAHT_SHARE_VIEWER_URL - Base URL for /share command (default: https://draht.dev/session/)\n DRAHT_AI_ANTIGRAVITY_VERSION - Override Antigravity User-Agent version (e.g., 1.23.0)\n\n${chalk.bold(\"Available Tools (default: read, bash, edit, write):\")}\n read - Read file contents\n bash - Execute bash commands\n edit - Edit files with find/replace\n write - Write files (creates/overwrites)\n grep - Search file contents (read-only, off by default)\n find - Find files by glob pattern (read-only, off by default)\n ls - List directory contents (read-only, off by default)\n`);\n}\n"]}
1
+ {"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAC5C,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAiI9C;AAED,wBAAgB,SAAS,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CAqJhE","sourcesContent":["/**\n * CLI argument parsing and help display\n */\n\nimport type { ThinkingLevel } from \"@draht/agent-core\";\nimport chalk from \"chalk\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from \"../config.js\";\nimport type { ExtensionFlag } from \"../core/extensions/types.js\";\nimport { allTools, type ToolName } from \"../core/tools/index.js\";\n\nexport type Mode = \"text\" | \"json\" | \"rpc\";\n\nexport interface Args {\n\tprovider?: string;\n\tmodel?: string;\n\tapiKey?: string;\n\tsystemPrompt?: string;\n\tappendSystemPrompt?: string;\n\tthinking?: ThinkingLevel;\n\tcontinue?: boolean;\n\tresume?: boolean;\n\thelp?: boolean;\n\tversion?: boolean;\n\tmode?: Mode;\n\tnoSession?: boolean;\n\tsession?: string;\n\tfork?: string;\n\tsessionDir?: string;\n\tmodels?: string[];\n\ttools?: ToolName[];\n\tnoTools?: boolean;\n\textensions?: string[];\n\tnoExtensions?: boolean;\n\tprint?: boolean;\n\texport?: string;\n\tnoSkills?: boolean;\n\tskills?: string[];\n\tpromptTemplates?: string[];\n\tnoPromptTemplates?: boolean;\n\tthemes?: string[];\n\tnoThemes?: boolean;\n\tlistModels?: string | true;\n\toffline?: boolean;\n\tverbose?: boolean;\n\tmessages: string[];\n\tfileArgs: string[];\n\t/** Unknown flags (potentially extension flags) - map of flag name to value */\n\tunknownFlags: Map<string, boolean | string>;\n\tdiagnostics: Array<{ type: \"warning\" | \"error\"; message: string }>;\n}\n\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\n\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\n}\n\nexport function parseArgs(args: string[]): Args {\n\tconst result: Args = {\n\t\tmessages: [],\n\t\tfileArgs: [],\n\t\tunknownFlags: new Map(),\n\t\tdiagnostics: [],\n\t};\n\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\tresult.help = true;\n\t\t} else if (arg === \"--version\" || arg === \"-v\") {\n\t\t\tresult.version = true;\n\t\t} else if (arg === \"--mode\" && i + 1 < args.length) {\n\t\t\tconst mode = args[++i];\n\t\t\tif (mode === \"text\" || mode === \"json\" || mode === \"rpc\") {\n\t\t\t\tresult.mode = mode;\n\t\t\t}\n\t\t} else if (arg === \"--continue\" || arg === \"-c\") {\n\t\t\tresult.continue = true;\n\t\t} else if (arg === \"--resume\" || arg === \"-r\") {\n\t\t\tresult.resume = true;\n\t\t} else if (arg === \"--provider\" && i + 1 < args.length) {\n\t\t\tresult.provider = args[++i];\n\t\t} else if (arg === \"--model\" && i + 1 < args.length) {\n\t\t\tresult.model = args[++i];\n\t\t} else if (arg === \"--api-key\" && i + 1 < args.length) {\n\t\t\tresult.apiKey = args[++i];\n\t\t} else if (arg === \"--system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.systemPrompt = args[++i];\n\t\t} else if (arg === \"--append-system-prompt\" && i + 1 < args.length) {\n\t\t\tresult.appendSystemPrompt = args[++i];\n\t\t} else if (arg === \"--no-session\") {\n\t\t\tresult.noSession = true;\n\t\t} else if (arg === \"--session\" && i + 1 < args.length) {\n\t\t\tresult.session = args[++i];\n\t\t} else if (arg === \"--fork\" && i + 1 < args.length) {\n\t\t\tresult.fork = args[++i];\n\t\t} else if (arg === \"--session-dir\" && i + 1 < args.length) {\n\t\t\tresult.sessionDir = args[++i];\n\t\t} else if (arg === \"--models\" && i + 1 < args.length) {\n\t\t\tresult.models = args[++i].split(\",\").map((s) => s.trim());\n\t\t} else if (arg === \"--no-tools\") {\n\t\t\tresult.noTools = true;\n\t\t} else if (arg === \"--tools\" && i + 1 < args.length) {\n\t\t\tconst toolNames = args[++i].split(\",\").map((s) => s.trim());\n\t\t\tconst validTools: ToolName[] = [];\n\t\t\tfor (const name of toolNames) {\n\t\t\t\tif (name in allTools) {\n\t\t\t\t\tvalidTools.push(name as ToolName);\n\t\t\t\t} else {\n\t\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\t\tmessage: `Unknown tool \"${name}\". Valid tools: ${Object.keys(allTools).join(\", \")}`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\tresult.tools = validTools;\n\t\t} else if (arg === \"--thinking\" && i + 1 < args.length) {\n\t\t\tconst level = args[++i];\n\t\t\tif (isValidThinkingLevel(level)) {\n\t\t\t\tresult.thinking = level;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\tmessage: `Invalid thinking level \"${level}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\n\t\t\t\t});\n\t\t\t}\n\t\t} else if (arg === \"--print\" || arg === \"-p\") {\n\t\t\tresult.print = true;\n\t\t} else if (arg === \"--export\" && i + 1 < args.length) {\n\t\t\tresult.export = args[++i];\n\t\t} else if ((arg === \"--extension\" || arg === \"-e\") && i + 1 < args.length) {\n\t\t\tresult.extensions = result.extensions ?? [];\n\t\t\tresult.extensions.push(args[++i]);\n\t\t} else if (arg === \"--no-extensions\" || arg === \"-ne\") {\n\t\t\tresult.noExtensions = true;\n\t\t} else if (arg === \"--skill\" && i + 1 < args.length) {\n\t\t\tresult.skills = result.skills ?? [];\n\t\t\tresult.skills.push(args[++i]);\n\t\t} else if (arg === \"--prompt-template\" && i + 1 < args.length) {\n\t\t\tresult.promptTemplates = result.promptTemplates ?? [];\n\t\t\tresult.promptTemplates.push(args[++i]);\n\t\t} else if (arg === \"--theme\" && i + 1 < args.length) {\n\t\t\tresult.themes = result.themes ?? [];\n\t\t\tresult.themes.push(args[++i]);\n\t\t} else if (arg === \"--no-skills\" || arg === \"-ns\") {\n\t\t\tresult.noSkills = true;\n\t\t} else if (arg === \"--no-prompt-templates\" || arg === \"-np\") {\n\t\t\tresult.noPromptTemplates = true;\n\t\t} else if (arg === \"--no-themes\") {\n\t\t\tresult.noThemes = true;\n\t\t} else if (arg === \"--list-models\") {\n\t\t\t// Check if next arg is a search pattern (not a flag or file arg)\n\t\t\tif (i + 1 < args.length && !args[i + 1].startsWith(\"-\") && !args[i + 1].startsWith(\"@\")) {\n\t\t\t\tresult.listModels = args[++i];\n\t\t\t} else {\n\t\t\t\tresult.listModels = true;\n\t\t\t}\n\t\t} else if (arg === \"--verbose\") {\n\t\t\tresult.verbose = true;\n\t\t} else if (arg === \"--offline\") {\n\t\t\tresult.offline = true;\n\t\t} else if (arg.startsWith(\"@\")) {\n\t\t\tresult.fileArgs.push(arg.slice(1)); // Remove @ prefix\n\t\t} else if (arg.startsWith(\"--\")) {\n\t\t\tconst eqIndex = arg.indexOf(\"=\");\n\t\t\tif (eqIndex !== -1) {\n\t\t\t\tresult.unknownFlags.set(arg.slice(2, eqIndex), arg.slice(eqIndex + 1));\n\t\t\t} else {\n\t\t\t\tconst flagName = arg.slice(2);\n\t\t\t\tconst next = args[i + 1];\n\t\t\t\tif (next !== undefined && !next.startsWith(\"-\") && !next.startsWith(\"@\")) {\n\t\t\t\t\tresult.unknownFlags.set(flagName, next);\n\t\t\t\t\ti++;\n\t\t\t\t} else {\n\t\t\t\t\tresult.unknownFlags.set(flagName, true);\n\t\t\t\t}\n\t\t\t}\n\t\t} else if (arg.startsWith(\"-\") && !arg.startsWith(\"--\")) {\n\t\t\tresult.diagnostics.push({ type: \"error\", message: `Unknown option: ${arg}` });\n\t\t} else if (!arg.startsWith(\"-\")) {\n\t\t\tresult.messages.push(arg);\n\t\t}\n\t}\n\n\treturn result;\n}\n\nexport function printHelp(extensionFlags?: ExtensionFlag[]): void {\n\tconst extensionFlagsText =\n\t\textensionFlags && extensionFlags.length > 0\n\t\t\t? `\\n${chalk.bold(\"Extension CLI Flags:\")}\\n${extensionFlags\n\t\t\t\t\t.map((flag) => {\n\t\t\t\t\t\tconst value = flag.type === \"string\" ? \" <value>\" : \"\";\n\t\t\t\t\t\tconst description = flag.description ?? `Registered by ${flag.extensionPath}`;\n\t\t\t\t\t\treturn ` --${flag.name}${value}`.padEnd(30) + description;\n\t\t\t\t\t})\n\t\t\t\t\t.join(\"\\n\")}\\n`\n\t\t\t: \"\";\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n ${APP_NAME} [options] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n ${APP_NAME} install <source> [-l] Install extension source and add to settings\n ${APP_NAME} remove <source> [-l] Remove extension source from settings\n ${APP_NAME} uninstall <source> [-l] Alias for remove\n ${APP_NAME} update [source] Update installed extensions (skips pinned sources)\n ${APP_NAME} list List installed extensions from settings\n ${APP_NAME} config Open TUI to enable/disable package resources\n ${APP_NAME} <command> --help Show help for install/remove/uninstall/update/list\n\n${chalk.bold(\"Options:\")}\n --provider <name> Provider name (default: google)\n --model <pattern> Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n --api-key <key> API key (defaults to env vars)\n --system-prompt <text> System prompt (default: coding assistant prompt)\n --append-system-prompt <text> Append text or file contents to the system prompt\n --mode <mode> Output mode: text (default), json, or rpc\n --print, -p Non-interactive mode: process prompt and exit\n --continue, -c Continue previous session\n --resume, -r Select a session to resume\n --session <path> Use specific session file\n --fork <path> Fork specific session file or partial UUID into a new session\n --session-dir <dir> Directory for session storage and lookup\n --no-session Don't save session (ephemeral)\n --models <patterns> Comma-separated model patterns for Ctrl+P cycling\n Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n --no-tools Disable all built-in tools\n --tools <tools> Comma-separated list of tools to enable (default: read,bash,edit,write)\n Available: read, bash, edit, write, grep, find, ls\n --thinking <level> Set thinking level: off, minimal, low, medium, high, xhigh\n --extension, -e <path> Load an extension file (can be used multiple times)\n --no-extensions, -ne Disable extension discovery (explicit -e paths still work)\n --skill <path> Load a skill file or directory (can be used multiple times)\n --no-skills, -ns Disable skills discovery and loading\n --prompt-template <path> Load a prompt template file or directory (can be used multiple times)\n --no-prompt-templates, -np Disable prompt template discovery and loading\n --theme <path> Load a theme file or directory (can be used multiple times)\n --no-themes Disable theme discovery and loading\n --export <file> Export session file to HTML and exit\n --list-models [search] List available models (with optional fuzzy search)\n --verbose Force verbose startup (overrides quietStartup setting)\n --offline Disable startup network operations (same as PI_OFFLINE=1)\n --help, -h Show this help\n --version, -v Show version number\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}\n\n${chalk.bold(\"Examples:\")}\n # Interactive mode\n ${APP_NAME}\n\n # Interactive mode with initial prompt\n ${APP_NAME} \"List all .ts files in src/\"\n\n # Include files in initial message\n ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n # Non-interactive mode (process and exit)\n ${APP_NAME} -p \"List all .ts files in src/\"\n\n # Multiple messages (interactive)\n ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n # Continue previous session\n ${APP_NAME} --continue \"What did we discuss?\"\n\n # Use different model\n ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n # Use model with provider prefix (no --provider needed)\n ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n # Use model with thinking level shorthand\n ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n # Limit model cycling to specific models\n ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n # Limit to a specific provider with glob pattern\n ${APP_NAME} --models \"github-copilot/*\"\n\n # Cycle models with fixed thinking levels\n ${APP_NAME} --models sonnet:high,haiku:low\n\n # Start with a specific thinking level\n ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n # Read-only mode (no file modifications possible)\n ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n # Export a session file to HTML\n ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n ${APP_NAME} --export session.jsonl output.html\n\n${chalk.bold(\"Environment Variables:\")}\n ANTHROPIC_API_KEY - Anthropic Claude API key\n ANTHROPIC_OAUTH_TOKEN - Anthropic OAuth token (alternative to API key)\n OPENAI_API_KEY - OpenAI GPT API key\n AZURE_OPENAI_API_KEY - Azure OpenAI API key\n AZURE_OPENAI_BASE_URL - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)\n AZURE_OPENAI_RESOURCE_NAME - Azure OpenAI resource name (alternative to base URL)\n AZURE_OPENAI_API_VERSION - Azure OpenAI API version (default: v1)\n AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n GEMINI_API_KEY - Google Gemini API key\n GROQ_API_KEY - Groq API key\n CEREBRAS_API_KEY - Cerebras API key\n XAI_API_KEY - xAI Grok API key\n OPENROUTER_API_KEY - OpenRouter API key\n AI_GATEWAY_API_KEY - Vercel AI Gateway API key\n ZAI_API_KEY - ZAI API key\n MISTRAL_API_KEY - Mistral API key\n MINIMAX_API_KEY - MiniMax API key\n OPENCODE_API_KEY - OpenCode Zen/OpenCode Go API key\n KIMI_API_KEY - Kimi For Coding API key\n AWS_PROFILE - AWS profile for Amazon Bedrock\n AWS_ACCESS_KEY_ID - AWS access key for Amazon Bedrock\n AWS_SECRET_ACCESS_KEY - AWS secret key for Amazon Bedrock\n AWS_BEARER_TOKEN_BEDROCK - Bedrock API key (bearer token)\n AWS_REGION - AWS region for Amazon Bedrock (e.g., us-east-1)\n ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)\n PI_PACKAGE_DIR - Override package directory (for Nix/Guix store paths)\n PI_OFFLINE - Disable startup network operations when set to 1/true/yes\n PI_SHARE_VIEWER_URL - Base URL for /share command (default: https://pi.dev/session/)\n PI_AI_ANTIGRAVITY_VERSION - Override Antigravity User-Agent version (e.g., 1.23.0)\n\n${chalk.bold(\"Available Tools (default: read, bash, edit, write):\")}\n read - Read file contents\n bash - Execute bash commands\n edit - Edit files with find/replace\n write - Write files (creates/overwrites)\n grep - Search file contents (read-only, off by default)\n find - Find files by glob pattern (read-only, off by default)\n ls - List directory contents (read-only, off by default)\n`);\n}\n"]}