@draht/coding-agent 2026.5.12 → 2026.7.7

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 (652) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +1 -4
  3. package/bin/draht-tools.cjs +3756 -1
  4. package/dist/bun/cli.d.ts.map +1 -1
  5. package/dist/bun/cli.js +4 -2
  6. package/dist/bun/cli.js.map +1 -1
  7. package/dist/bun/register-bedrock.d.ts.map +1 -1
  8. package/dist/bun/register-bedrock.js +1 -1
  9. package/dist/bun/register-bedrock.js.map +1 -1
  10. package/dist/bun/restore-sandbox-env.d.ts +17 -0
  11. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  12. package/dist/bun/restore-sandbox-env.js +36 -0
  13. package/dist/bun/restore-sandbox-env.js.map +1 -0
  14. package/dist/cli/args.d.ts +9 -4
  15. package/dist/cli/args.d.ts.map +1 -1
  16. package/dist/cli/args.js +91 -38
  17. package/dist/cli/args.js.map +1 -1
  18. package/dist/cli/config-selector.d.ts +5 -3
  19. package/dist/cli/config-selector.d.ts.map +1 -1
  20. package/dist/cli/config-selector.js +1 -1
  21. package/dist/cli/config-selector.js.map +1 -1
  22. package/dist/cli/file-processor.d.ts.map +1 -1
  23. package/dist/cli/file-processor.js +13 -26
  24. package/dist/cli/file-processor.js.map +1 -1
  25. package/dist/cli/initial-message.d.ts +1 -1
  26. package/dist/cli/initial-message.d.ts.map +1 -1
  27. package/dist/cli/initial-message.js.map +1 -1
  28. package/dist/cli/list-models.d.ts +1 -1
  29. package/dist/cli/list-models.d.ts.map +1 -1
  30. package/dist/cli/list-models.js +7 -1
  31. package/dist/cli/list-models.js.map +1 -1
  32. package/dist/cli/project-trust.d.ts +10 -0
  33. package/dist/cli/project-trust.d.ts.map +1 -0
  34. package/dist/cli/project-trust.js +48 -0
  35. package/dist/cli/project-trust.js.map +1 -0
  36. package/dist/cli/session-picker.d.ts +3 -2
  37. package/dist/cli/session-picker.d.ts.map +1 -1
  38. package/dist/cli/session-picker.js +5 -4
  39. package/dist/cli/session-picker.js.map +1 -1
  40. package/dist/cli/startup-ui.d.ts +20 -0
  41. package/dist/cli/startup-ui.d.ts.map +1 -0
  42. package/dist/cli/startup-ui.js +184 -0
  43. package/dist/cli/startup-ui.js.map +1 -0
  44. package/dist/cli.d.ts.map +1 -1
  45. package/dist/cli.js +7 -4
  46. package/dist/cli.js.map +1 -1
  47. package/dist/config.d.ts +27 -13
  48. package/dist/config.d.ts.map +1 -1
  49. package/dist/config.js +284 -63
  50. package/dist/config.js.map +1 -1
  51. package/dist/core/agent-session-runtime.d.ts +45 -9
  52. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  53. package/dist/core/agent-session-runtime.js +100 -33
  54. package/dist/core/agent-session-runtime.js.map +1 -1
  55. package/dist/core/agent-session-services.d.ts +6 -4
  56. package/dist/core/agent-session-services.d.ts.map +1 -1
  57. package/dist/core/agent-session-services.js +7 -4
  58. package/dist/core/agent-session-services.js.map +1 -1
  59. package/dist/core/agent-session.d.ts +55 -33
  60. package/dist/core/agent-session.d.ts.map +1 -1
  61. package/dist/core/agent-session.js +560 -492
  62. package/dist/core/agent-session.js.map +1 -1
  63. package/dist/core/auth-guidance.d.ts +5 -0
  64. package/dist/core/auth-guidance.d.ts.map +1 -0
  65. package/dist/core/auth-guidance.js +21 -0
  66. package/dist/core/auth-guidance.js.map +1 -0
  67. package/dist/core/auth-storage.d.ts +21 -13
  68. package/dist/core/auth-storage.d.ts.map +1 -1
  69. package/dist/core/auth-storage.js +48 -28
  70. package/dist/core/auth-storage.js.map +1 -1
  71. package/dist/core/bash-executor.d.ts +1 -15
  72. package/dist/core/bash-executor.d.ts.map +1 -1
  73. package/dist/core/bash-executor.js +10 -24
  74. package/dist/core/bash-executor.js.map +1 -1
  75. package/dist/core/builtins/subagent.d.ts.map +1 -1
  76. package/dist/core/builtins/subagent.js +1 -2
  77. package/dist/core/builtins/subagent.js.map +1 -1
  78. package/dist/core/compaction/branch-summarization.d.ts +9 -5
  79. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  80. package/dist/core/compaction/branch-summarization.js +10 -4
  81. package/dist/core/compaction/branch-summarization.js.map +1 -1
  82. package/dist/core/compaction/compaction.d.ts +8 -7
  83. package/dist/core/compaction/compaction.d.ts.map +1 -1
  84. package/dist/core/compaction/compaction.js +56 -47
  85. package/dist/core/compaction/compaction.js.map +1 -1
  86. package/dist/core/compaction/index.d.ts +3 -3
  87. package/dist/core/compaction/index.d.ts.map +1 -1
  88. package/dist/core/compaction/index.js.map +1 -1
  89. package/dist/core/compaction/utils.d.ts +1 -1
  90. package/dist/core/compaction/utils.d.ts.map +1 -1
  91. package/dist/core/compaction/utils.js +1 -1
  92. package/dist/core/compaction/utils.js.map +1 -1
  93. package/dist/core/exec.d.ts.map +1 -1
  94. package/dist/core/exec.js.map +1 -1
  95. package/dist/core/experimental.d.ts +2 -0
  96. package/dist/core/experimental.d.ts.map +1 -0
  97. package/dist/core/experimental.js +4 -0
  98. package/dist/core/experimental.js.map +1 -0
  99. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  100. package/dist/core/export-html/ansi-to-html.js +1 -1
  101. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  102. package/dist/core/export-html/index.d.ts +1 -1
  103. package/dist/core/export-html/index.d.ts.map +1 -1
  104. package/dist/core/export-html/index.js +13 -11
  105. package/dist/core/export-html/index.js.map +1 -1
  106. package/dist/core/export-html/template.css +69 -4
  107. package/dist/core/export-html/template.js +231 -57
  108. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  109. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  110. package/dist/core/export-html/tool-renderer.js +15 -2
  111. package/dist/core/export-html/tool-renderer.js.map +1 -1
  112. package/dist/core/export-html/vendor/marked.min.js +75 -3
  113. package/dist/core/extensions/index.d.ts +8 -8
  114. package/dist/core/extensions/index.d.ts.map +1 -1
  115. package/dist/core/extensions/index.js.map +1 -1
  116. package/dist/core/extensions/loader.d.ts +5 -6
  117. package/dist/core/extensions/loader.d.ts.map +1 -1
  118. package/dist/core/extensions/loader.js +98 -43
  119. package/dist/core/extensions/loader.js.map +1 -1
  120. package/dist/core/extensions/runner.d.ts +31 -12
  121. package/dist/core/extensions/runner.d.ts.map +1 -1
  122. package/dist/core/extensions/runner.js +248 -33
  123. package/dist/core/extensions/runner.js.map +1 -1
  124. package/dist/core/extensions/types.d.ts +191 -36
  125. package/dist/core/extensions/types.d.ts.map +1 -1
  126. package/dist/core/extensions/types.js.map +1 -1
  127. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  128. package/dist/core/extensions/wrapper.js +2 -2
  129. package/dist/core/extensions/wrapper.js.map +1 -1
  130. package/dist/core/footer-data-provider.d.ts +7 -1
  131. package/dist/core/footer-data-provider.d.ts.map +1 -1
  132. package/dist/core/footer-data-provider.js +78 -54
  133. package/dist/core/footer-data-provider.js.map +1 -1
  134. package/dist/core/http-dispatcher.d.ts +22 -0
  135. package/dist/core/http-dispatcher.d.ts.map +1 -0
  136. package/dist/core/http-dispatcher.js +91 -0
  137. package/dist/core/http-dispatcher.js.map +1 -0
  138. package/dist/core/index.d.ts +9 -8
  139. package/dist/core/index.d.ts.map +1 -1
  140. package/dist/core/index.js +2 -1
  141. package/dist/core/index.js.map +1 -1
  142. package/dist/core/keybindings.d.ts +67 -2
  143. package/dist/core/keybindings.d.ts.map +1 -1
  144. package/dist/core/keybindings.js +59 -7
  145. package/dist/core/keybindings.js.map +1 -1
  146. package/dist/core/model-registry.d.ts +24 -5
  147. package/dist/core/model-registry.d.ts.map +1 -1
  148. package/dist/core/model-registry.js +188 -51
  149. package/dist/core/model-registry.js.map +1 -1
  150. package/dist/core/model-resolver.d.ts +12 -1
  151. package/dist/core/model-resolver.d.ts.map +1 -1
  152. package/dist/core/model-resolver.js +84 -39
  153. package/dist/core/model-resolver.js.map +1 -1
  154. package/dist/core/output-guard.d.ts +1 -0
  155. package/dist/core/output-guard.d.ts.map +1 -1
  156. package/dist/core/output-guard.js +52 -22
  157. package/dist/core/output-guard.js.map +1 -1
  158. package/dist/core/package-manager.d.ts +22 -4
  159. package/dist/core/package-manager.d.ts.map +1 -1
  160. package/dist/core/package-manager.js +455 -157
  161. package/dist/core/package-manager.js.map +1 -1
  162. package/dist/core/project-trust.d.ts +15 -0
  163. package/dist/core/project-trust.d.ts.map +1 -0
  164. package/dist/core/project-trust.js +59 -0
  165. package/dist/core/project-trust.js.map +1 -0
  166. package/dist/core/prompt-templates.d.ts +13 -11
  167. package/dist/core/prompt-templates.d.ts.map +1 -1
  168. package/dist/core/prompt-templates.js +67 -76
  169. package/dist/core/prompt-templates.js.map +1 -1
  170. package/dist/core/provider-attribution.d.ts +4 -0
  171. package/dist/core/provider-attribution.d.ts.map +1 -0
  172. package/dist/core/provider-attribution.js +72 -0
  173. package/dist/core/provider-attribution.js.map +1 -0
  174. package/dist/core/provider-display-names.d.ts +2 -0
  175. package/dist/core/provider-display-names.d.ts.map +1 -0
  176. package/dist/core/provider-display-names.js +36 -0
  177. package/dist/core/provider-display-names.js.map +1 -0
  178. package/dist/core/resolve-config-value.d.ts +13 -6
  179. package/dist/core/resolve-config-value.d.ts.map +1 -1
  180. package/dist/core/resolve-config-value.js +143 -22
  181. package/dist/core/resolve-config-value.js.map +1 -1
  182. package/dist/core/resource-loader.d.ts +36 -15
  183. package/dist/core/resource-loader.d.ts.map +1 -1
  184. package/dist/core/resource-loader.js +178 -79
  185. package/dist/core/resource-loader.js.map +1 -1
  186. package/dist/core/sdk.d.ts +34 -18
  187. package/dist/core/sdk.d.ts.map +1 -1
  188. package/dist/core/sdk.js +47 -16
  189. package/dist/core/sdk.js.map +1 -1
  190. package/dist/core/session-manager.d.ts +32 -14
  191. package/dist/core/session-manager.d.ts.map +1 -1
  192. package/dist/core/session-manager.js +366 -209
  193. package/dist/core/session-manager.js.map +1 -1
  194. package/dist/core/settings-manager.d.ts +62 -6
  195. package/dist/core/settings-manager.d.ts.map +1 -1
  196. package/dist/core/settings-manager.js +230 -40
  197. package/dist/core/settings-manager.js.map +1 -1
  198. package/dist/core/skills.d.ts +10 -10
  199. package/dist/core/skills.d.ts.map +1 -1
  200. package/dist/core/skills.js +13 -35
  201. package/dist/core/skills.js.map +1 -1
  202. package/dist/core/slash-commands.d.ts +1 -1
  203. package/dist/core/slash-commands.d.ts.map +1 -1
  204. package/dist/core/slash-commands.js +7 -4
  205. package/dist/core/slash-commands.js.map +1 -1
  206. package/dist/core/source-info.d.ts +1 -1
  207. package/dist/core/source-info.d.ts.map +1 -1
  208. package/dist/core/source-info.js.map +1 -1
  209. package/dist/core/system-prompt.d.ts +4 -4
  210. package/dist/core/system-prompt.d.ts.map +1 -1
  211. package/dist/core/system-prompt.js +20 -16
  212. package/dist/core/system-prompt.js.map +1 -1
  213. package/dist/core/telemetry.d.ts +3 -0
  214. package/dist/core/telemetry.d.ts.map +1 -0
  215. package/dist/core/telemetry.js +9 -0
  216. package/dist/core/telemetry.js.map +1 -0
  217. package/dist/core/timings.d.ts +4 -2
  218. package/dist/core/timings.d.ts.map +1 -1
  219. package/dist/core/timings.js +24 -14
  220. package/dist/core/timings.js.map +1 -1
  221. package/dist/core/tools/bash.d.ts +11 -16
  222. package/dist/core/tools/bash.d.ts.map +1 -1
  223. package/dist/core/tools/bash.js +187 -178
  224. package/dist/core/tools/bash.js.map +1 -1
  225. package/dist/core/tools/edit-diff.d.ts +26 -5
  226. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  227. package/dist/core/tools/edit-diff.js +110 -23
  228. package/dist/core/tools/edit-diff.js.map +1 -1
  229. package/dist/core/tools/edit.d.ts +22 -24
  230. package/dist/core/tools/edit.d.ts.map +1 -1
  231. package/dist/core/tools/edit.js +201 -113
  232. package/dist/core/tools/edit.js.map +1 -1
  233. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  234. package/dist/core/tools/file-mutation-queue.js +27 -12
  235. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  236. package/dist/core/tools/find.d.ts +7 -18
  237. package/dist/core/tools/find.d.ts.map +1 -1
  238. package/dist/core/tools/find.js +148 -101
  239. package/dist/core/tools/find.js.map +1 -1
  240. package/dist/core/tools/grep.d.ts +11 -30
  241. package/dist/core/tools/grep.d.ts.map +1 -1
  242. package/dist/core/tools/grep.js +23 -12
  243. package/dist/core/tools/grep.js.map +1 -1
  244. package/dist/core/tools/index.d.ts +26 -101
  245. package/dist/core/tools/index.d.ts.map +1 -1
  246. package/dist/core/tools/index.js +78 -52
  247. package/dist/core/tools/index.js.map +1 -1
  248. package/dist/core/tools/ls.d.ts +6 -15
  249. package/dist/core/tools/ls.d.ts.map +1 -1
  250. package/dist/core/tools/ls.js +12 -17
  251. package/dist/core/tools/ls.js.map +1 -1
  252. package/dist/core/tools/output-accumulator.d.ts +52 -0
  253. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  254. package/dist/core/tools/output-accumulator.js +184 -0
  255. package/dist/core/tools/output-accumulator.js.map +1 -0
  256. package/dist/core/tools/path-utils.d.ts +2 -0
  257. package/dist/core/tools/path-utils.d.ts.map +1 -1
  258. package/dist/core/tools/path-utils.js +40 -22
  259. package/dist/core/tools/path-utils.js.map +1 -1
  260. package/dist/core/tools/read.d.ts +7 -18
  261. package/dist/core/tools/read.d.ts.map +1 -1
  262. package/dist/core/tools/read.js +103 -52
  263. package/dist/core/tools/read.js.map +1 -1
  264. package/dist/core/tools/render-utils.d.ts +5 -2
  265. package/dist/core/tools/render-utils.d.ts.map +1 -1
  266. package/dist/core/tools/render-utils.js +18 -2
  267. package/dist/core/tools/render-utils.js.map +1 -1
  268. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  269. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  270. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  271. package/dist/core/tools/truncate.d.ts.map +1 -1
  272. package/dist/core/tools/truncate.js +12 -2
  273. package/dist/core/tools/truncate.js.map +1 -1
  274. package/dist/core/tools/write.d.ts +5 -14
  275. package/dist/core/tools/write.d.ts.map +1 -1
  276. package/dist/core/tools/write.js +27 -46
  277. package/dist/core/tools/write.js.map +1 -1
  278. package/dist/core/trust-manager.d.ts +36 -0
  279. package/dist/core/trust-manager.d.ts.map +1 -0
  280. package/dist/core/trust-manager.js +202 -0
  281. package/dist/core/trust-manager.js.map +1 -0
  282. package/dist/index.d.ts +33 -29
  283. package/dist/index.d.ts.map +1 -1
  284. package/dist/index.js +12 -9
  285. package/dist/index.js.map +1 -1
  286. package/dist/main.d.ts +5 -1
  287. package/dist/main.d.ts.map +1 -1
  288. package/dist/main.js +208 -93
  289. package/dist/main.js.map +1 -1
  290. package/dist/migrations.d.ts +2 -2
  291. package/dist/migrations.d.ts.map +1 -1
  292. package/dist/migrations.js +4 -4
  293. package/dist/migrations.js.map +1 -1
  294. package/dist/modes/index.d.ts +5 -5
  295. package/dist/modes/index.d.ts.map +1 -1
  296. package/dist/modes/index.js.map +1 -1
  297. package/dist/modes/interactive/assets/clankolas.png +0 -0
  298. package/dist/modes/interactive/components/assistant-message.d.ts +5 -1
  299. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/assistant-message.js +37 -15
  301. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  302. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  303. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/bash-execution.js +3 -3
  305. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  306. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  307. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  308. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  309. package/dist/modes/interactive/components/config-selector.d.ts +36 -5
  310. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/config-selector.js +318 -36
  312. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  313. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  314. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  316. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  317. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  318. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  319. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  320. package/dist/modes/interactive/components/custom-entry.d.ts +19 -0
  321. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -0
  322. package/dist/modes/interactive/components/custom-entry.js +52 -0
  323. package/dist/modes/interactive/components/custom-entry.js.map +1 -0
  324. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  325. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  326. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  327. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  328. package/dist/modes/interactive/components/diff.js.map +1 -1
  329. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  330. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  331. package/dist/modes/interactive/components/extension-editor.d.ts +3 -1
  332. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  333. package/dist/modes/interactive/components/extension-editor.js +26 -9
  334. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  335. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  336. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  337. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  338. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/extension-selector.js +8 -3
  340. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  341. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  342. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  343. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  344. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  345. package/dist/modes/interactive/components/footer.d.ts +4 -3
  346. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/footer.js +27 -7
  348. package/dist/modes/interactive/components/footer.js.map +1 -1
  349. package/dist/modes/interactive/components/index.d.ts +33 -31
  350. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/index.js +2 -0
  352. package/dist/modes/interactive/components/index.js.map +1 -1
  353. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  354. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  356. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  357. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  358. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/login-dialog.js +45 -11
  360. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  361. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  362. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/model-selector.js +10 -6
  364. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  366. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  368. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  369. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  370. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  371. package/dist/modes/interactive/components/scoped-models-selector.js +49 -31
  372. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  373. package/dist/modes/interactive/components/session-selector.d.ts +2 -2
  374. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  375. package/dist/modes/interactive/components/session-selector.js +33 -14
  376. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  377. package/dist/modes/interactive/components/settings-selector.d.ts +17 -0
  378. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  379. package/dist/modes/interactive/components/settings-selector.js +301 -20
  380. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  381. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  382. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  383. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  384. package/dist/modes/interactive/components/status-indicator.d.ts +28 -0
  385. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -0
  386. package/dist/modes/interactive/components/status-indicator.js +60 -0
  387. package/dist/modes/interactive/components/status-indicator.js.map +1 -0
  388. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  390. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  391. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  392. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  393. package/dist/modes/interactive/components/tool-execution.js +57 -14
  394. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  395. package/dist/modes/interactive/components/tree-selector.d.ts +1 -1
  396. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  397. package/dist/modes/interactive/components/tree-selector.js +137 -13
  398. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  399. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  400. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  401. package/dist/modes/interactive/components/trust-selector.js +91 -0
  402. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  403. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  404. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  405. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  406. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  407. package/dist/modes/interactive/components/user-message.d.ts +6 -1
  408. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/user-message.js +22 -8
  410. package/dist/modes/interactive/components/user-message.js.map +1 -1
  411. package/dist/modes/interactive/interactive-mode.d.ts +76 -19
  412. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  413. package/dist/modes/interactive/interactive-mode.js +1294 -494
  414. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  415. package/dist/modes/interactive/model-search.d.ts +12 -0
  416. package/dist/modes/interactive/model-search.d.ts.map +1 -0
  417. package/dist/modes/interactive/model-search.js +15 -0
  418. package/dist/modes/interactive/model-search.js.map +1 -0
  419. package/dist/modes/interactive/theme/dark.json +5 -4
  420. package/dist/modes/interactive/theme/light.json +5 -4
  421. package/dist/modes/interactive/theme/theme-controller.d.ts +29 -0
  422. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -0
  423. package/dist/modes/interactive/theme/theme-controller.js +102 -0
  424. package/dist/modes/interactive/theme/theme-controller.js.map +1 -0
  425. package/dist/modes/interactive/theme/theme-schema.json +2 -1
  426. package/dist/modes/interactive/theme/theme.d.ts +41 -3
  427. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  428. package/dist/modes/interactive/theme/theme.js +183 -106
  429. package/dist/modes/interactive/theme/theme.js.map +1 -1
  430. package/dist/modes/print-mode.d.ts.map +1 -1
  431. package/dist/modes/print-mode.js +40 -20
  432. package/dist/modes/print-mode.js.map +1 -1
  433. package/dist/modes/rpc/rpc-client.d.ts +30 -5
  434. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  435. package/dist/modes/rpc/rpc-client.js +87 -8
  436. package/dist/modes/rpc/rpc-client.js.map +1 -1
  437. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  438. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  439. package/dist/modes/rpc/rpc-mode.js +113 -31
  440. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  441. package/dist/modes/rpc/rpc-types.d.ts +42 -4
  442. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  443. package/dist/modes/rpc/rpc-types.js.map +1 -1
  444. package/dist/package-manager-cli.d.ts +6 -2
  445. package/dist/package-manager-cli.d.ts.map +1 -1
  446. package/dist/package-manager-cli.js +504 -25
  447. package/dist/package-manager-cli.js.map +1 -1
  448. package/dist/prompts/commands/brainstorm.md +148 -0
  449. package/dist/prompts/commands/map-codebase.md +14 -0
  450. package/dist/rpc-entry.d.ts +3 -0
  451. package/dist/rpc-entry.d.ts.map +1 -0
  452. package/dist/rpc-entry.js +10 -0
  453. package/dist/rpc-entry.js.map +1 -0
  454. package/dist/utils/ansi.d.ts +2 -0
  455. package/dist/utils/ansi.d.ts.map +1 -0
  456. package/dist/utils/ansi.js +52 -0
  457. package/dist/utils/ansi.js.map +1 -0
  458. package/dist/utils/changelog.d.ts +2 -1
  459. package/dist/utils/changelog.d.ts.map +1 -1
  460. package/dist/utils/changelog.js +78 -0
  461. package/dist/utils/changelog.js.map +1 -1
  462. package/dist/utils/child-process.d.ts +12 -5
  463. package/dist/utils/child-process.d.ts.map +1 -1
  464. package/dist/utils/child-process.js +33 -5
  465. package/dist/utils/child-process.js.map +1 -1
  466. package/dist/utils/clipboard-image.d.ts.map +1 -1
  467. package/dist/utils/clipboard-image.js +2 -2
  468. package/dist/utils/clipboard-image.js.map +1 -1
  469. package/dist/utils/clipboard-native.d.ts +3 -1
  470. package/dist/utils/clipboard-native.d.ts.map +1 -1
  471. package/dist/utils/clipboard-native.js +14 -8
  472. package/dist/utils/clipboard-native.js.map +1 -1
  473. package/dist/utils/clipboard.d.ts.map +1 -1
  474. package/dist/utils/clipboard.js +84 -45
  475. package/dist/utils/clipboard.js.map +1 -1
  476. package/dist/utils/deprecation.d.ts +4 -0
  477. package/dist/utils/deprecation.d.ts.map +1 -0
  478. package/dist/utils/deprecation.js +13 -0
  479. package/dist/utils/deprecation.js.map +1 -0
  480. package/dist/utils/exif-orientation.d.ts +1 -1
  481. package/dist/utils/exif-orientation.d.ts.map +1 -1
  482. package/dist/utils/exif-orientation.js.map +1 -1
  483. package/dist/utils/fs-watch.d.ts +5 -0
  484. package/dist/utils/fs-watch.d.ts.map +1 -0
  485. package/dist/utils/fs-watch.js +25 -0
  486. package/dist/utils/fs-watch.js.map +1 -0
  487. package/dist/utils/git.d.ts.map +1 -1
  488. package/dist/utils/git.js +54 -22
  489. package/dist/utils/git.js.map +1 -1
  490. package/dist/utils/html.d.ts +7 -0
  491. package/dist/utils/html.d.ts.map +1 -0
  492. package/dist/utils/html.js +40 -0
  493. package/dist/utils/html.js.map +1 -0
  494. package/dist/utils/image-convert.d.ts +1 -0
  495. package/dist/utils/image-convert.d.ts.map +1 -1
  496. package/dist/utils/image-convert.js +21 -15
  497. package/dist/utils/image-convert.js.map +1 -1
  498. package/dist/utils/image-process.d.ts +18 -0
  499. package/dist/utils/image-process.d.ts.map +1 -0
  500. package/dist/utils/image-process.js +83 -0
  501. package/dist/utils/image-process.js.map +1 -0
  502. package/dist/utils/image-resize-core.d.ts +30 -0
  503. package/dist/utils/image-resize-core.d.ts.map +1 -0
  504. package/dist/utils/image-resize-core.js +124 -0
  505. package/dist/utils/image-resize-core.js.map +1 -0
  506. package/dist/utils/image-resize-worker.d.ts +2 -0
  507. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  508. package/dist/utils/image-resize-worker.js +31 -0
  509. package/dist/utils/image-resize-worker.js.map +1 -0
  510. package/dist/utils/image-resize.d.ts +7 -27
  511. package/dist/utils/image-resize.d.ts.map +1 -1
  512. package/dist/utils/image-resize.js +75 -115
  513. package/dist/utils/image-resize.js.map +1 -1
  514. package/dist/utils/json.d.ts +3 -0
  515. package/dist/utils/json.d.ts.map +1 -0
  516. package/dist/utils/json.js +7 -0
  517. package/dist/utils/json.js.map +1 -0
  518. package/dist/utils/mime.d.ts +1 -0
  519. package/dist/utils/mime.d.ts.map +1 -1
  520. package/dist/utils/mime.js +100 -16
  521. package/dist/utils/mime.js.map +1 -1
  522. package/dist/utils/open-browser.d.ts +9 -0
  523. package/dist/utils/open-browser.d.ts.map +1 -0
  524. package/dist/utils/open-browser.js +22 -0
  525. package/dist/utils/open-browser.js.map +1 -0
  526. package/dist/utils/paths.d.ts +25 -1
  527. package/dist/utils/paths.d.ts.map +1 -1
  528. package/dist/utils/paths.js +75 -2
  529. package/dist/utils/paths.js.map +1 -1
  530. package/dist/utils/pi-user-agent.d.ts +2 -0
  531. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  532. package/dist/utils/pi-user-agent.js +5 -0
  533. package/dist/utils/pi-user-agent.js.map +1 -0
  534. package/dist/utils/shell.d.ts +11 -6
  535. package/dist/utils/shell.d.ts.map +1 -1
  536. package/dist/utils/shell.js +42 -26
  537. package/dist/utils/shell.js.map +1 -1
  538. package/dist/utils/syntax-highlight.d.ts +12 -0
  539. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  540. package/dist/utils/syntax-highlight.js +118 -0
  541. package/dist/utils/syntax-highlight.js.map +1 -0
  542. package/dist/utils/tools-manager.d.ts.map +1 -1
  543. package/dist/utils/tools-manager.js +86 -10
  544. package/dist/utils/tools-manager.js.map +1 -1
  545. package/dist/utils/version-check.d.ts +15 -0
  546. package/dist/utils/version-check.d.ts.map +1 -0
  547. package/dist/utils/version-check.js +59 -0
  548. package/dist/utils/version-check.js.map +1 -0
  549. package/dist/utils/windows-self-update.d.ts +3 -0
  550. package/dist/utils/windows-self-update.d.ts.map +1 -0
  551. package/dist/utils/windows-self-update.js +77 -0
  552. package/dist/utils/windows-self-update.js.map +1 -0
  553. package/docs/compaction.md +12 -12
  554. package/docs/containerization.md +111 -0
  555. package/docs/custom-provider.md +187 -47
  556. package/docs/development.md +5 -5
  557. package/docs/docs.json +156 -0
  558. package/docs/extensions.md +520 -79
  559. package/docs/index.md +82 -0
  560. package/docs/json.md +4 -4
  561. package/docs/keybindings.md +24 -2
  562. package/docs/models.md +119 -17
  563. package/docs/packages.md +19 -11
  564. package/docs/prompt-templates.md +30 -2
  565. package/docs/providers.md +85 -23
  566. package/docs/quickstart.md +165 -0
  567. package/docs/rpc.md +99 -10
  568. package/docs/sdk.md +118 -50
  569. package/docs/security.md +55 -0
  570. package/docs/{session.md → session-format.md} +29 -19
  571. package/docs/sessions.md +145 -0
  572. package/docs/settings.md +71 -11
  573. package/docs/skills.md +16 -17
  574. package/docs/terminal-setup.md +44 -2
  575. package/docs/termux.md +4 -4
  576. package/docs/themes.md +3 -3
  577. package/docs/tmux.md +4 -2
  578. package/docs/tui.md +44 -4
  579. package/docs/usage.md +305 -0
  580. package/examples/extensions/README.md +1 -0
  581. package/examples/extensions/border-status-editor.ts +145 -0
  582. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  583. package/examples/extensions/custom-compaction.ts +2 -1
  584. package/examples/extensions/custom-header.ts +1 -1
  585. package/examples/extensions/custom-provider-anthropic/index.ts +2 -2
  586. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  587. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  588. package/examples/extensions/custom-provider-gitlab-duo/index.ts +63 -8
  589. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  590. package/examples/extensions/custom-provider-gitlab-duo/test.ts +2 -2
  591. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  592. package/examples/extensions/doom-overlay/index.ts +1 -1
  593. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  594. package/examples/extensions/dynamic-tools.ts +2 -2
  595. package/examples/extensions/entry-renderer.ts +41 -0
  596. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  597. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  598. package/examples/extensions/gondolin/index.ts +531 -0
  599. package/examples/extensions/gondolin/package-lock.json +185 -0
  600. package/examples/extensions/gondolin/package.json +19 -0
  601. package/examples/extensions/handoff.ts +52 -14
  602. package/examples/extensions/input-transform-streaming.ts +39 -0
  603. package/examples/extensions/interactive-shell.ts +1 -1
  604. package/examples/extensions/notify.ts +2 -9
  605. package/examples/extensions/overlay-qa-tests.ts +240 -138
  606. package/examples/extensions/overlay-test.ts +7 -4
  607. package/examples/extensions/plan-mode/index.ts +87 -37
  608. package/examples/extensions/plan-mode/utils.ts +1 -1
  609. package/examples/extensions/preset.ts +46 -7
  610. package/examples/extensions/project-trust.ts +64 -0
  611. package/examples/extensions/prompt-customizer.ts +97 -0
  612. package/examples/extensions/provider-payload.ts +8 -4
  613. package/examples/extensions/qna.ts +3 -3
  614. package/examples/extensions/question.ts +34 -20
  615. package/examples/extensions/questionnaire.ts +43 -30
  616. package/examples/extensions/reload-runtime.ts +1 -1
  617. package/examples/extensions/sandbox/index.ts +6 -6
  618. package/examples/extensions/sandbox/package-lock.json +5 -5
  619. package/examples/extensions/sandbox/package.json +2 -2
  620. package/examples/extensions/shutdown-command.ts +1 -1
  621. package/examples/extensions/snake.ts +1 -1
  622. package/examples/extensions/space-invaders.ts +1 -1
  623. package/examples/extensions/structured-output.ts +65 -0
  624. package/examples/extensions/subagent/agents.ts +2 -2
  625. package/examples/extensions/subagent/index.ts +58 -29
  626. package/examples/extensions/summarize.ts +3 -2
  627. package/examples/extensions/tic-tac-toe.ts +1008 -0
  628. package/examples/extensions/titlebar-spinner.ts +2 -2
  629. package/examples/extensions/todo.ts +2 -2
  630. package/examples/extensions/tool-override.ts +1 -1
  631. package/examples/extensions/tools.ts +5 -0
  632. package/examples/extensions/truncated-tool.ts +1 -1
  633. package/examples/extensions/with-deps/index.ts +1 -1
  634. package/examples/extensions/with-deps/package-lock.json +2 -2
  635. package/examples/extensions/with-deps/package.json +3 -3
  636. package/examples/extensions/working-indicator.ts +123 -0
  637. package/examples/extensions/working-message-test.ts +25 -0
  638. package/examples/sdk/01-minimal.ts +14 -10
  639. package/examples/sdk/02-custom-model.ts +13 -9
  640. package/examples/sdk/03-custom-prompt.ts +32 -17
  641. package/examples/sdk/04-skills.ts +5 -2
  642. package/examples/sdk/05-tools.ts +23 -31
  643. package/examples/sdk/06-extensions.ts +14 -8
  644. package/examples/sdk/07-context-files.ts +5 -3
  645. package/examples/sdk/08-prompt-templates.ts +5 -2
  646. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  647. package/examples/sdk/10-settings.ts +8 -6
  648. package/examples/sdk/11-sessions.ts +4 -0
  649. package/examples/sdk/12-full-control.ts +15 -19
  650. package/package.json +22 -16
  651. package/prompts/commands/brainstorm.md +148 -0
  652. package/prompts/commands/map-codebase.md +14 -0
package/docs/usage.md ADDED
@@ -0,0 +1,305 @@
1
+ # Using Pi
2
+
3
+ This page collects day-to-day usage details that do not fit on the quickstart page.
4
+
5
+ ## Interactive Mode
6
+
7
+ <p align="center"><img src="images/interactive-mode.png" alt="Interactive Mode" width="600"></p>
8
+
9
+ The interface has four main areas:
10
+
11
+ - **Startup header** - shortcuts, loaded context files, prompt templates, skills, and extensions
12
+ - **Messages** - user messages, assistant responses, tool calls, tool results, notifications, errors, and extension UI
13
+ - **Editor** - where you type; border color indicates the current thinking level
14
+ - **Footer** - working directory, session name, token/cache usage, cost, context usage, and current model
15
+
16
+ The editor can be replaced temporarily by built-in UI such as `/settings` or by custom extension UI.
17
+
18
+ ### Editor Features
19
+
20
+ | Feature | How |
21
+ |---------|-----|
22
+ | File reference | Type `@` to fuzzy-search project files |
23
+ | Path completion | Press Tab to complete paths |
24
+ | Multi-line input | Shift+Enter, or Ctrl+Enter on Windows Terminal |
25
+ | Images | Paste with Ctrl+V, Alt+V on Windows, or drag into the terminal |
26
+ | Shell command | `!command` runs and sends output to the model |
27
+ | Hidden shell command | `!!command` runs without sending output to the model |
28
+ | External editor | Ctrl+G opens `externalEditor`, `$VISUAL`, `$EDITOR`, Notepad on Windows, or `nano` elsewhere |
29
+
30
+ See [Keybindings](keybindings.md) for all shortcuts and customization.
31
+
32
+ ## Slash Commands
33
+
34
+ Type `/` in the editor to open command completion. Extensions can register custom commands, skills are available as `/skill:name`, and prompt templates expand via `/templatename`.
35
+
36
+ | Command | Description |
37
+ |---------|-------------|
38
+ | `/login`, `/logout` | Manage OAuth or API-key credentials |
39
+ | `/model` | Switch models |
40
+ | `/scoped-models` | Enable/disable models for Ctrl+P cycling |
41
+ | `/settings` | Thinking level, theme, message delivery, transport |
42
+ | `/resume` | Pick from previous sessions |
43
+ | `/new` | Start a new session |
44
+ | `/name <name>` | Set session display name |
45
+ | `/session` | Show session file, ID, messages, tokens, and cost |
46
+ | `/tree` | Jump to any point in the session and continue from there |
47
+ | `/fork` | Create a new session from a previous user message |
48
+ | `/clone` | Duplicate the current active branch into a new session |
49
+ | `/compact [prompt]` | Manually compact context, optionally with custom instructions |
50
+ | `/copy` | Copy last assistant message to clipboard |
51
+ | `/export [file]` | Export session to HTML |
52
+ | `/share` | Upload as private GitHub gist with shareable HTML link |
53
+ | `/reload` | Reload keybindings, extensions, skills, prompts, and context files |
54
+ | `/hotkeys` | Show all keyboard shortcuts |
55
+ | `/changelog` | Display version history |
56
+ | `/quit` | Quit pi |
57
+
58
+ ## Message Queue
59
+
60
+ You can submit messages while the agent is still working:
61
+
62
+ - **Enter** queues a steering message, delivered after the current assistant turn finishes executing its tool calls.
63
+ - **Alt+Enter** queues a follow-up message, delivered after the agent finishes all work.
64
+ - **Escape** aborts and restores queued messages to the editor.
65
+ - **Alt+Up** retrieves queued messages back to the editor.
66
+
67
+ On Windows Terminal, Alt+Enter is fullscreen by default. Remap it as described in [Terminal setup](terminal-setup.md) if you want pi to receive the shortcut.
68
+
69
+ Configure delivery in [Settings](settings.md) with `steeringMode` and `followUpMode`.
70
+
71
+ ## Sessions
72
+
73
+ Sessions are saved automatically to `~/.pi/agent/sessions/`, organized by working directory.
74
+
75
+ ```bash
76
+ pi -c # Continue most recent session
77
+ pi -r # Browse and select a session
78
+ pi --no-session # Ephemeral mode; do not save
79
+ pi --name "my task" # Set session display name at startup
80
+ pi --session <path|id> # Use a specific session file or session ID
81
+ pi --fork <path|id> # Fork a session into a new session file
82
+ ```
83
+
84
+ Useful session commands:
85
+
86
+ - `/session` shows the current session file and ID.
87
+ - `/tree` navigates the in-file session tree and can summarize abandoned branches.
88
+ - `/fork` creates a new session from an earlier user message.
89
+ - `/clone` duplicates the current active branch into a new session file.
90
+ - `/compact` summarizes older messages to free context.
91
+
92
+ See [Sessions](sessions.md) and [Compaction](compaction.md) for details.
93
+
94
+ ## Context Files
95
+
96
+ Pi loads `AGENTS.md` or `CLAUDE.md` at startup from:
97
+
98
+ - `~/.pi/agent/AGENTS.md` for global instructions
99
+ - parent directories, walking up from the current working directory
100
+ - the current directory
101
+
102
+ Use context files for project conventions, commands, safety rules, and preferences. Disable loading with `--no-context-files` or `-nc`.
103
+
104
+ ### System Prompt Files
105
+
106
+ Replace the default system prompt with:
107
+
108
+ - `.pi/SYSTEM.md` for a project
109
+ - `~/.pi/agent/SYSTEM.md` globally
110
+
111
+ Append to the default prompt without replacing it with `APPEND_SYSTEM.md` in either location.
112
+
113
+ ### Project Trust
114
+
115
+ On interactive startup, pi asks before trusting a project folder that contains project-local extensions or settings and has no saved decision for the folder or a parent folder in `~/.pi/agent/trust.json`. Trusting a project allows pi to load `.pi/settings.json` and `.pi` resources, install missing project packages, and execute project extensions.
116
+
117
+ Before the trust decision, pi loads only context files, user/global extensions, and CLI `-e` extensions so they can handle the `project_trust` event. Project-local extensions, project package-managed extensions, and project settings are loaded only after the project is trusted. This split also applies when switching to a session from a different cwd whose trust has not been resolved in the current process.
118
+
119
+ Non-interactive modes (`-p`, `--mode json`, and `--mode rpc`) do not show a trust prompt. Without an applicable saved trust decision, they use `defaultProjectTrust` from global settings: `ask` (default) and `never` ignore trust-gated project inputs, while `always` trusts them. Pass `--approve`/`-a` or `--no-approve`/`-na` to override project trust for one run.
120
+
121
+ If no extension or saved decision applies, `defaultProjectTrust` controls the fallback behavior. Set it to `"ask"`, `"always"`, or `"never"` in `~/.pi/agent/settings.json`, or change it with `/settings`.
122
+
123
+ `pi config` and package commands use the same project trust flow. Pass `--approve` to trust project-local settings for one command or `--no-approve` to ignore them.
124
+
125
+ Use `/trust` in interactive mode to save a project trust decision for future sessions, including trust for the immediate parent folder. It writes `~/.pi/agent/trust.json` only; the current session is not reloaded, so restart pi for changes to take effect.
126
+
127
+
128
+ ## Exporting and Sharing Sessions
129
+
130
+ Use `/export [file]` to write a session to HTML.
131
+
132
+ Use `/share` to upload a private GitHub gist with a shareable HTML link.
133
+
134
+ If you use pi for open source work and want to publish sessions for model, prompt, tool, and evaluation research, see [`badlogic/pi-share-hf`](https://github.com/badlogic/pi-share-hf). It publishes sessions to Hugging Face datasets.
135
+
136
+ ## CLI Reference
137
+
138
+ ```bash
139
+ pi [options] [@files...] [messages...]
140
+ ```
141
+
142
+ ### Package Commands
143
+
144
+ ```bash
145
+ pi install <source> [-l] # Install package, -l for project-local
146
+ pi remove <source> [-l] # Remove package
147
+ pi uninstall <source> [-l] # Alias for remove
148
+ pi update [source|self|pi] # Update pi and packages; reconcile pinned git refs
149
+ pi update --extensions # Update packages only; reconcile pinned git refs
150
+ pi update --self # Update pi only
151
+ pi update --extension <src> # Update one package
152
+ pi list # List installed packages
153
+ pi config # Enable/disable package resources
154
+ ```
155
+
156
+ These commands manage pi packages, not the pi CLI installation. To uninstall pi itself, see [Quickstart](quickstart.md#uninstall). `pi config` and project package commands accept `--approve`/`--no-approve` to trust or ignore project-local settings for one command.
157
+
158
+ See [Pi Packages](packages.md) for package sources and security notes.
159
+
160
+ ### Modes
161
+
162
+ | Flag | Description |
163
+ |------|-------------|
164
+ | default | Interactive mode |
165
+ | `-p`, `--print` | Print response and exit |
166
+ | `--mode json` | Output all events as JSON lines; see [JSON mode](json.md) |
167
+ | `--mode rpc` | RPC mode over stdin/stdout; see [RPC mode](rpc.md) |
168
+ | `--export <in> [out]` | Export a session to HTML |
169
+
170
+ In print mode, pi also reads piped stdin and merges it into the initial prompt:
171
+
172
+ ```bash
173
+ cat README.md | pi -p "Summarize this text"
174
+ ```
175
+
176
+ ### Model Options
177
+
178
+ | Option | Description |
179
+ |--------|-------------|
180
+ | `--provider <name>` | Provider, such as `anthropic`, `openai`, or `google` |
181
+ | `--model <pattern>` | Model pattern or ID; supports `provider/id` and optional `:<thinking>` |
182
+ | `--api-key <key>` | API key, overriding environment variables |
183
+ | `--thinking <level>` | `off`, `minimal`, `low`, `medium`, `high`, `xhigh` |
184
+ | `--models <patterns>` | Comma-separated patterns for Ctrl+P cycling |
185
+ | `--list-models [search]` | List available models |
186
+
187
+ ### Session Options
188
+
189
+ | Option | Description |
190
+ |--------|-------------|
191
+ | `-c`, `--continue` | Continue the most recent session |
192
+ | `-r`, `--resume` | Browse and select a session |
193
+ | `--session <path\|id>` | Use a specific session file or partial UUID |
194
+ | `--fork <path\|id>` | Fork a session file or partial UUID into a new session |
195
+ | `--session-dir <dir>` | Custom session storage directory |
196
+ | `--no-session` | Ephemeral mode; do not save |
197
+ | `--name <name>`, `-n <name>` | Set session display name at startup |
198
+
199
+ ### Tool Options
200
+
201
+ | Option | Description |
202
+ |--------|-------------|
203
+ | `--tools <list>`, `-t <list>` | Allowlist specific built-in, extension, and custom tools |
204
+ | `--exclude-tools <list>`, `-xt <list>` | Disable specific built-in, extension, and custom tools |
205
+ | `--no-builtin-tools`, `-nbt` | Disable built-in tools but keep extension/custom tools enabled |
206
+ | `--no-tools`, `-nt` | Disable all tools |
207
+
208
+ Built-in tools: `read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`.
209
+
210
+ ### Resource Options
211
+
212
+ | Option | Description |
213
+ |--------|-------------|
214
+ | `-e`, `--extension <source>` | Load an extension from path, npm, or git; repeatable |
215
+ | `--no-extensions` | Disable extension discovery |
216
+ | `--skill <path>` | Load a skill; repeatable |
217
+ | `--no-skills` | Disable skill discovery |
218
+ | `--prompt-template <path>` | Load a prompt template; repeatable |
219
+ | `--no-prompt-templates` | Disable prompt template discovery |
220
+ | `--theme <path>` | Load a theme; repeatable |
221
+ | `--no-themes` | Disable theme discovery |
222
+ | `--no-context-files`, `-nc` | Disable `AGENTS.md` and `CLAUDE.md` discovery |
223
+
224
+ Combine `--no-*` with explicit flags to load exactly what you need, ignoring settings. Example:
225
+
226
+ ```bash
227
+ pi --no-extensions -e ./my-extension.ts
228
+ ```
229
+
230
+ ### Other Options
231
+
232
+ | Option | Description |
233
+ |--------|-------------|
234
+ | `--system-prompt <text>` | Replace default prompt; context files and skills are still appended |
235
+ | `--append-system-prompt <text>` | Append to system prompt |
236
+ | `--verbose` | Force verbose startup |
237
+ | `-a`, `--approve` | Trust project-local files for this run |
238
+ | `-na`, `--no-approve` | Ignore project-local files for this run |
239
+ | `-h`, `--help` | Show help |
240
+ | `-v`, `--version` | Show version |
241
+
242
+ ### File Arguments
243
+
244
+ Prefix files with `@` to include them in the message:
245
+
246
+ ```bash
247
+ pi @prompt.md "Answer this"
248
+ pi -p @screenshot.png "What's in this image?"
249
+ pi @code.ts @test.ts "Review these files"
250
+ ```
251
+
252
+ ### Examples
253
+
254
+ ```bash
255
+ # Interactive with initial prompt
256
+ pi "List all .ts files in src/"
257
+
258
+ # Non-interactive
259
+ pi -p "Summarize this codebase"
260
+
261
+ # Non-interactive with piped stdin
262
+ cat README.md | pi -p "Summarize this text"
263
+
264
+ # Named one-shot session
265
+ pi --name "release audit" -p "Audit this repository"
266
+
267
+ # Different model
268
+ pi --provider openai --model gpt-4o "Help me refactor"
269
+
270
+ # Model with provider prefix
271
+ pi --model openai/gpt-4o "Help me refactor"
272
+
273
+ # Model with thinking level shorthand
274
+ pi --model sonnet:high "Solve this complex problem"
275
+
276
+ # Limit model cycling
277
+ pi --models "claude-*,gpt-4o"
278
+
279
+ # Read-only mode
280
+ pi --tools read,grep,find,ls -p "Review the code"
281
+
282
+ # Disable one extension or built-in tool while keeping the rest available
283
+ pi --exclude-tools ask_question
284
+ ```
285
+
286
+ ### Environment Variables
287
+
288
+ | Variable | Description |
289
+ |----------|-------------|
290
+ | `PI_CODING_AGENT_DIR` | Override config directory; default is `~/.pi/agent` |
291
+ | `PI_CODING_AGENT_SESSION_DIR` | Override session storage directory; overridden by `--session-dir` |
292
+ | `PI_PACKAGE_DIR` | Override package directory, useful for Nix/Guix store paths |
293
+ | `PI_OFFLINE` | Disable startup network operations, including update checks, package update checks, and install/update telemetry |
294
+ | `PI_SKIP_VERSION_CHECK` | Skip the Pi version update check at startup. This prevents the `pi.dev` latest-version request |
295
+ | `PI_TELEMETRY` | Override install/update telemetry and provider attribution headers: `1`/`true`/`yes` or `0`/`false`/`no`. This does not disable update checks |
296
+ | `PI_CACHE_RETENTION` | Set to `long` for extended prompt cache where supported |
297
+ | `VISUAL`, `EDITOR` | Fallback external editor for Ctrl+G when `externalEditor` is unset; defaults to Notepad on Windows and `nano` elsewhere |
298
+
299
+ ## Design Principles
300
+
301
+ Pi keeps the core small and pushes workflow-specific behavior into extensions, skills, prompt templates, and packages.
302
+
303
+ It intentionally does not include built-in MCP, sub-agents, permission popups, plan mode, to-dos, or background bash. You can build or install those workflows as extensions or packages, or use external tools such as containers and tmux.
304
+
305
+ For the full rationale, read the [blog post](https://mariozechner.at/posts/2025-11-30-pi-coding-agent/).
@@ -106,6 +106,7 @@ cp permission-gate.ts ~/.draht/agent/extensions/
106
106
  | Extension | Description |
107
107
  |-----------|-------------|
108
108
  | `message-renderer.ts` | Custom message rendering with colors and expandable details via `registerMessageRenderer` |
109
+ | `entry-renderer.ts` | TUI-only session entry rendering via `appendEntry` and `registerEntryRenderer` |
109
110
  | `event-bus.ts` | Inter-extension communication via `pi.events` |
110
111
 
111
112
  ### Session Metadata
@@ -0,0 +1,145 @@
1
+ import { CustomEditor, type ExtensionAPI, type ExtensionContext, type KeybindingsManager } from "@draht/coding-agent";
2
+ import type { Component, EditorTheme, TUI } from "@draht/tui";
3
+ import { truncateToWidth, visibleWidth } from "@draht/tui";
4
+
5
+ function fitBorder(
6
+ left: string,
7
+ right: string,
8
+ width: number,
9
+ border: (text: string) => string,
10
+ fill: (text: string) => string = border,
11
+ ): string {
12
+ if (width <= 0) return "";
13
+ if (width === 1) return border("─");
14
+
15
+ let leftText = left;
16
+ let rightText = right;
17
+ const fixedWidth = 2;
18
+ const minimumGap = 3;
19
+
20
+ while (
21
+ fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minimumGap > width &&
22
+ visibleWidth(rightText) > 0
23
+ ) {
24
+ rightText = truncateToWidth(rightText, Math.max(0, visibleWidth(rightText) - 1), "");
25
+ }
26
+ while (
27
+ fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minimumGap > width &&
28
+ visibleWidth(leftText) > 0
29
+ ) {
30
+ leftText = truncateToWidth(leftText, Math.max(0, visibleWidth(leftText) - 1), "");
31
+ }
32
+
33
+ const gapWidth = Math.max(0, width - fixedWidth - visibleWidth(leftText) - visibleWidth(rightText));
34
+ return `${border("─")}${leftText}${fill("─".repeat(gapWidth))}${rightText}${border("─")}`;
35
+ }
36
+
37
+ function formatCwd(cwd: string): string {
38
+ const home = process.env.HOME;
39
+ if (home && cwd.startsWith(home)) {
40
+ return `~${cwd.slice(home.length)}`;
41
+ }
42
+ return cwd;
43
+ }
44
+
45
+ function formatContext(ctx: ExtensionContext): string {
46
+ const usage = ctx.getContextUsage();
47
+ const contextWindow = usage?.contextWindow ?? ctx.model?.contextWindow;
48
+ if (!contextWindow || !usage || usage.percent === null) {
49
+ return "ctx ?";
50
+ }
51
+ return `ctx ${Math.round(usage.percent)}%/${(contextWindow / 1000).toFixed(0)}k`;
52
+ }
53
+
54
+ function formatThinking(level: string): string {
55
+ return level === "off" ? "off" : level;
56
+ }
57
+
58
+ class EmptyFooter implements Component {
59
+ render(): string[] {
60
+ return [];
61
+ }
62
+
63
+ invalidate(): void {}
64
+ }
65
+
66
+ export default function (pi: ExtensionAPI) {
67
+ let isWorking = false;
68
+ let spinnerIndex = 0;
69
+ let spinnerTimer: ReturnType<typeof setInterval> | undefined;
70
+ let activeTui: TUI | undefined;
71
+ const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
72
+
73
+ const stopSpinner = () => {
74
+ if (spinnerTimer) {
75
+ clearInterval(spinnerTimer);
76
+ spinnerTimer = undefined;
77
+ }
78
+ };
79
+
80
+ pi.on("agent_start", () => {
81
+ isWorking = true;
82
+ stopSpinner();
83
+ spinnerTimer = setInterval(() => {
84
+ spinnerIndex = (spinnerIndex + 1) % spinnerFrames.length;
85
+ activeTui?.requestRender();
86
+ }, 80);
87
+ activeTui?.requestRender();
88
+ });
89
+
90
+ pi.on("agent_end", () => {
91
+ isWorking = false;
92
+ stopSpinner();
93
+ activeTui?.requestRender();
94
+ });
95
+
96
+ pi.on("session_shutdown", () => {
97
+ stopSpinner();
98
+ activeTui = undefined;
99
+ });
100
+
101
+ pi.on("session_start", (_event, ctx) => {
102
+ ctx.ui.setWorkingVisible(false);
103
+ ctx.ui.setFooter(() => new EmptyFooter());
104
+
105
+ let branch: string | undefined;
106
+
107
+ const refreshBranch = async () => {
108
+ const result = await pi.exec("git", ["branch", "--show-current"], { cwd: ctx.cwd }).catch(() => undefined);
109
+ const stdout = result?.stdout.trim();
110
+ branch = stdout && stdout.length > 0 ? stdout : undefined;
111
+ activeTui?.requestRender();
112
+ };
113
+ void refreshBranch();
114
+
115
+ class BorderStatusEditor extends CustomEditor {
116
+ constructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) {
117
+ super(tui, theme, keybindings, { paddingX: 0 });
118
+ activeTui = tui;
119
+ }
120
+
121
+ render(width: number): string[] {
122
+ const lines = super.render(width);
123
+ if (lines.length < 2) return lines;
124
+
125
+ const thm = ctx.ui.theme;
126
+ const model = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : "no model";
127
+ const thinking = pi.getThinkingLevel();
128
+ const topLeft = isWorking ? thm.fg("accent", ` ${spinnerFrames[spinnerIndex]} `) : "";
129
+ const topRight = "";
130
+ const bottomLeft = thm.fg("muted", ` ${model} · ${formatThinking(thinking)} `);
131
+ const bottomRight = thm.fg(
132
+ "muted",
133
+ ` ${formatContext(ctx)} · ${formatCwd(ctx.cwd)}${branch ? ` (${branch})` : ""} `,
134
+ );
135
+ const borderColor = (text: string) => this.borderColor(text);
136
+
137
+ lines[0] = fitBorder(topLeft, topRight, width, borderColor);
138
+ lines[lines.length - 1] = fitBorder(bottomLeft, bottomRight, width, borderColor);
139
+ return lines;
140
+ }
141
+ }
142
+
143
+ ctx.ui.setEditorComponent((tui, theme, keybindings) => new BorderStatusEditor(tui, theme, keybindings));
144
+ });
145
+ }
@@ -16,6 +16,8 @@
16
16
  * and delegate execute() to them
17
17
  * - renderCall() controls what's shown when the tool is invoked
18
18
  * - renderResult() controls what's shown after execution completes
19
+ * - renderShell: "self" lets a tool render its own outer shell instead of
20
+ * using the default boxed shell from ToolExecutionComponent
19
21
  * - The `expanded` flag in renderResult indicates whether the user has
20
22
  * toggled the tool output open (via ctrl+e or clicking)
21
23
  *
@@ -155,6 +157,7 @@ export default function (pi: ExtensionAPI) {
155
157
  label: "edit",
156
158
  description: originalEdit.description,
157
159
  parameters: originalEdit.parameters,
160
+ renderShell: "self",
158
161
 
159
162
  async execute(toolCallId, params, signal, onUpdate) {
160
163
  return originalEdit.execute(toolCallId, params, signal, onUpdate);
@@ -13,7 +13,7 @@
13
13
  * pi --extension examples/extensions/custom-compaction.ts
14
14
  */
15
15
 
16
- import { complete } from "@draht/ai";
16
+ import { complete } from "@draht/ai/compat";
17
17
  import type { ExtensionAPI } from "@draht/coding-agent";
18
18
  import { convertToLlm, serializeConversation } from "@draht/coding-agent";
19
19
 
@@ -93,6 +93,7 @@ ${conversationText}
93
93
  {
94
94
  apiKey: auth.apiKey,
95
95
  headers: auth.headers,
96
+ env: auth.env,
96
97
  maxTokens: 8192,
97
98
  signal,
98
99
  },
@@ -47,7 +47,7 @@ function getPiMascot(theme: Theme): string[] {
47
47
  export default function (pi: ExtensionAPI) {
48
48
  // Set custom header immediately on load (if UI is available)
49
49
  pi.on("session_start", async (_event, ctx) => {
50
- if (ctx.hasUI) {
50
+ if (ctx.mode === "tui") {
51
51
  ctx.ui.setHeader((_tui, theme) => {
52
52
  return {
53
53
  render(_width: number): string[] {
@@ -153,7 +153,7 @@ async function refreshAnthropicToken(credentials: OAuthCredentials): Promise<OAu
153
153
  }
154
154
 
155
155
  // =============================================================================
156
- // Streaming Implementation (simplified from packages/ai/src/providers/anthropic.ts)
156
+ // Streaming Implementation (simplified from packages/ai/src/api/anthropic-messages.ts)
157
157
  // =============================================================================
158
158
 
159
159
  // Claude Code tool names for OAuth stealth mode
@@ -568,7 +568,7 @@ function streamCustomAnthropic(
568
568
  export default function (pi: ExtensionAPI) {
569
569
  pi.registerProvider("custom-anthropic", {
570
570
  baseUrl: "https://api.anthropic.com",
571
- apiKey: "CUSTOM_ANTHROPIC_API_KEY",
571
+ apiKey: "$CUSTOM_ANTHROPIC_API_KEY",
572
572
  api: "custom-anthropic-api",
573
573
 
574
574
  models: [
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "pi-extension-custom-provider",
3
- "version": "1.7.0",
3
+ "version": "0.80.3",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "pi-extension-custom-provider",
9
- "version": "1.7.0",
9
+ "version": "0.80.3",
10
10
  "dependencies": {
11
11
  "@anthropic-ai/sdk": "^0.52.0"
12
12
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pi-extension-custom-provider-anthropic",
3
3
  "private": true,
4
- "version": "1.7.0",
4
+ "version": "0.80.3",
5
5
  "type": "module",
6
6
  "scripts": {
7
7
  "clean": "echo 'nothing to clean'",
@@ -14,6 +14,6 @@
14
14
  ]
15
15
  },
16
16
  "dependencies": {
17
- "@anthropic-ai/sdk": "^0.52.0"
17
+ "@anthropic-ai/sdk": "0.52.0"
18
18
  }
19
19
  }