@phren/cli 0.2.14 → 0.2.16

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 (387) hide show
  1. package/README.md +2 -2
  2. package/dist/agent-instructions.d.ts +12 -0
  3. package/dist/agent-instructions.js +52 -0
  4. package/dist/bridge/agent-hook-stores.d.ts +32 -0
  5. package/dist/bridge/agent-hook-stores.js +67 -0
  6. package/dist/bridge/agent-hooks.d.ts +193 -2
  7. package/dist/bridge/agent-hooks.js +1045 -38
  8. package/dist/bridge/canary.d.ts +27 -0
  9. package/dist/bridge/canary.js +189 -0
  10. package/dist/bridge/changes.d.ts +57 -0
  11. package/dist/bridge/changes.js +403 -0
  12. package/dist/bridge/client.d.ts +3 -0
  13. package/dist/bridge/client.js +36 -0
  14. package/dist/bridge/code-note.d.ts +22 -0
  15. package/dist/bridge/code-note.js +42 -0
  16. package/dist/bridge/code-routes.d.ts +133 -0
  17. package/dist/bridge/code-routes.js +319 -0
  18. package/dist/bridge/codex-threads.d.ts +27 -0
  19. package/dist/bridge/codex-threads.js +442 -0
  20. package/dist/bridge/command.d.ts +7 -0
  21. package/dist/bridge/command.js +50 -5
  22. package/dist/bridge/computer-names.d.ts +4 -0
  23. package/dist/bridge/computer-names.js +16 -0
  24. package/dist/bridge/computers.d.ts +9 -0
  25. package/dist/bridge/computers.js +111 -0
  26. package/dist/bridge/context.d.ts +14 -0
  27. package/dist/bridge/context.js +149 -0
  28. package/dist/bridge/dispatch-command.d.ts +3 -0
  29. package/dist/bridge/dispatch-command.js +93 -0
  30. package/dist/bridge/dispatch-hosts.d.ts +23 -0
  31. package/dist/bridge/dispatch-hosts.js +25 -0
  32. package/dist/bridge/dispatch-returns.d.ts +123 -0
  33. package/dist/bridge/dispatch-returns.js +279 -0
  34. package/dist/bridge/dispatch-tree.d.ts +54 -0
  35. package/dist/bridge/dispatch-tree.js +198 -0
  36. package/dist/bridge/dispatch.d.ts +207 -0
  37. package/dist/bridge/dispatch.js +261 -0
  38. package/dist/bridge/enroll.d.ts +31 -0
  39. package/dist/bridge/enroll.js +236 -0
  40. package/dist/bridge/fanout-messages.d.ts +74 -0
  41. package/dist/bridge/fanout-messages.js +230 -0
  42. package/dist/bridge/fanouts.d.ts +160 -0
  43. package/dist/bridge/fanouts.js +702 -0
  44. package/dist/bridge/file-range.d.ts +16 -0
  45. package/dist/bridge/file-range.js +90 -0
  46. package/dist/bridge/files.d.ts +20 -0
  47. package/dist/bridge/files.js +54 -0
  48. package/dist/bridge/git-publish.d.ts +23 -0
  49. package/dist/bridge/git-publish.js +145 -0
  50. package/dist/bridge/git-worktrees.d.ts +21 -0
  51. package/dist/bridge/git-worktrees.js +150 -0
  52. package/dist/bridge/git.d.ts +54 -0
  53. package/dist/bridge/git.js +552 -0
  54. package/dist/bridge/grants.d.ts +31 -0
  55. package/dist/bridge/grants.js +181 -0
  56. package/dist/bridge/hand-off.d.ts +79 -0
  57. package/dist/bridge/hand-off.js +151 -0
  58. package/dist/bridge/health.d.ts +128 -0
  59. package/dist/bridge/health.js +260 -0
  60. package/dist/bridge/herdr.d.ts +79 -6
  61. package/dist/bridge/herdr.js +292 -27
  62. package/dist/bridge/hook-main.js +2 -0
  63. package/dist/bridge/install.d.ts +32 -1
  64. package/dist/bridge/install.js +225 -38
  65. package/dist/bridge/launch-worktree.d.ts +21 -0
  66. package/dist/bridge/launch-worktree.js +70 -0
  67. package/dist/bridge/limits.d.ts +20 -0
  68. package/dist/bridge/limits.js +65 -0
  69. package/dist/bridge/locate.d.ts +16 -0
  70. package/dist/bridge/locate.js +75 -0
  71. package/dist/bridge/metrics.d.ts +29 -0
  72. package/dist/bridge/metrics.js +71 -0
  73. package/dist/bridge/model-switch.d.ts +35 -0
  74. package/dist/bridge/model-switch.js +250 -0
  75. package/dist/bridge/models.d.ts +46 -0
  76. package/dist/bridge/models.js +257 -0
  77. package/dist/bridge/opencode-approvals.d.ts +6 -0
  78. package/dist/bridge/opencode-approvals.js +60 -0
  79. package/dist/bridge/pane-text.d.ts +15 -0
  80. package/dist/bridge/pane-text.js +23 -0
  81. package/dist/bridge/peers.d.ts +27 -0
  82. package/dist/bridge/peers.js +130 -0
  83. package/dist/bridge/projects.d.ts +12 -1
  84. package/dist/bridge/projects.js +268 -20
  85. package/dist/bridge/protocol.d.ts +35 -2
  86. package/dist/bridge/protocol.js +42 -7
  87. package/dist/bridge/push.d.ts +83 -0
  88. package/dist/bridge/push.js +199 -0
  89. package/dist/bridge/questions.d.ts +38 -0
  90. package/dist/bridge/questions.js +205 -0
  91. package/dist/bridge/schedule-format.d.ts +103 -0
  92. package/dist/bridge/schedule-format.js +266 -0
  93. package/dist/bridge/schedule-launch.d.ts +11 -0
  94. package/dist/bridge/schedule-launch.js +169 -0
  95. package/dist/bridge/schedule-watch.d.ts +52 -0
  96. package/dist/bridge/schedule-watch.js +242 -0
  97. package/dist/bridge/schedules.d.ts +48 -0
  98. package/dist/bridge/schedules.js +205 -0
  99. package/dist/bridge/server-launch.d.ts +14 -0
  100. package/dist/bridge/server-launch.js +218 -0
  101. package/dist/bridge/server-overview.d.ts +45 -0
  102. package/dist/bridge/server-overview.js +102 -0
  103. package/dist/bridge/server-pane-routes.d.ts +29 -0
  104. package/dist/bridge/server-pane-routes.js +400 -0
  105. package/dist/bridge/server-routes.d.ts +106 -0
  106. package/dist/bridge/server-routes.js +538 -0
  107. package/dist/bridge/server-stream.d.ts +46 -0
  108. package/dist/bridge/server-stream.js +253 -0
  109. package/dist/bridge/server.d.ts +3 -15
  110. package/dist/bridge/server.js +162 -264
  111. package/dist/bridge/session-servers.d.ts +24 -0
  112. package/dist/bridge/session-servers.js +136 -0
  113. package/dist/bridge/side-questions.d.ts +74 -0
  114. package/dist/bridge/side-questions.js +252 -0
  115. package/dist/bridge/simulators.d.ts +28 -0
  116. package/dist/bridge/simulators.js +198 -0
  117. package/dist/bridge/speech-transcribe.d.ts +24 -0
  118. package/dist/bridge/speech-transcribe.js +124 -0
  119. package/dist/bridge/speech.d.ts +35 -0
  120. package/dist/bridge/speech.js +98 -0
  121. package/dist/bridge/steps.d.ts +13 -0
  122. package/dist/bridge/steps.js +222 -0
  123. package/dist/bridge/tab-activity.d.ts +18 -0
  124. package/dist/bridge/tab-activity.js +99 -0
  125. package/dist/bridge/terminal-choice.d.ts +64 -0
  126. package/dist/bridge/terminal-choice.js +281 -0
  127. package/dist/bridge/transcript-claude.d.ts +22 -0
  128. package/dist/bridge/transcript-claude.js +353 -0
  129. package/dist/bridge/transcript-codex.d.ts +30 -0
  130. package/dist/bridge/transcript-codex.js +282 -0
  131. package/dist/bridge/transcript-copilot.d.ts +4 -0
  132. package/dist/bridge/transcript-copilot.js +14 -0
  133. package/dist/bridge/transcript-opencode.d.ts +5 -0
  134. package/dist/bridge/transcript-opencode.js +26 -0
  135. package/dist/bridge/transcript-preview.d.ts +94 -0
  136. package/dist/bridge/transcript-preview.js +476 -0
  137. package/dist/bridge/transcripts.d.ts +81 -4
  138. package/dist/bridge/transcripts.js +332 -67
  139. package/dist/bridge/transport.d.ts +3 -0
  140. package/dist/bridge/transport.js +96 -15
  141. package/dist/bridge/uploads.d.ts +15 -0
  142. package/dist/bridge/uploads.js +44 -2
  143. package/dist/bridge/usage.d.ts +124 -0
  144. package/dist/bridge/usage.js +859 -0
  145. package/dist/bridge-hook.mjs +41246 -21385
  146. package/dist/cli/actions.js +14 -1
  147. package/dist/cli/config-proactivity.d.ts +3 -1
  148. package/dist/cli/config-proactivity.js +35 -3
  149. package/dist/cli/config.js +4 -1
  150. package/dist/cli/extract.js +3 -6
  151. package/dist/cli/govern.js +5 -2
  152. package/dist/cli/hooks-globs.js +1 -1
  153. package/dist/cli/hooks.d.ts +1 -1
  154. package/dist/cli/hooks.js +9 -7
  155. package/dist/cli/namespaces-projects.js +12 -6
  156. package/dist/cli/namespaces-store.js +37 -6
  157. package/dist/cli/namespaces-tasks.js +1 -1
  158. package/dist/cli/schedules.d.ts +1 -0
  159. package/dist/cli/schedules.js +164 -0
  160. package/dist/cli/session-background.js +1 -1
  161. package/dist/cli/session-git.d.ts +8 -5
  162. package/dist/cli/session-git.js +45 -120
  163. package/dist/cli/session-start.js +3 -1
  164. package/dist/cli/session-stop.js +19 -8
  165. package/dist/cli/team.js +13 -10
  166. package/dist/cli-handlers.d.ts +1 -1
  167. package/dist/cli-handlers.js +8 -4
  168. package/dist/cli-help.d.ts +5 -4
  169. package/dist/cli-help.js +15 -15
  170. package/dist/cli-registry.d.ts +4 -1
  171. package/dist/cli-registry.js +119 -6
  172. package/dist/content/archive.js +2 -2
  173. package/dist/content/citation.d.ts +11 -0
  174. package/dist/content/citation.js +18 -0
  175. package/dist/content/learning.js +2 -0
  176. package/dist/content/summarize.d.ts +14 -15
  177. package/dist/content/summarize.js +60 -5
  178. package/dist/content/validate.d.ts +3 -1
  179. package/dist/content/validate.js +26 -8
  180. package/dist/core/project-registry.d.ts +26 -0
  181. package/dist/core/project-registry.js +573 -0
  182. package/dist/core/project.js +2 -3
  183. package/dist/data/access.d.ts +7 -1
  184. package/dist/data/access.js +13 -3
  185. package/dist/data/tasks.d.ts +18 -3
  186. package/dist/data/tasks.js +8 -7
  187. package/dist/entrypoint.js +44 -10
  188. package/dist/fanout/adapters/claude.d.ts +2 -0
  189. package/dist/fanout/adapters/claude.js +7 -0
  190. package/dist/fanout/adapters/codex.d.ts +2 -0
  191. package/dist/fanout/adapters/codex.js +9 -0
  192. package/dist/fanout/adapters/opencode.d.ts +4 -0
  193. package/dist/fanout/adapters/opencode.js +9 -0
  194. package/dist/fanout/adapters/types.d.ts +21 -0
  195. package/dist/fanout/adapters/types.js +3 -0
  196. package/dist/fanout/command.d.ts +2 -0
  197. package/dist/fanout/command.js +78 -0
  198. package/dist/fanout/launcher.d.ts +27 -0
  199. package/dist/fanout/launcher.js +156 -0
  200. package/dist/fanout/opencode-serve.d.ts +24 -0
  201. package/dist/fanout/opencode-serve.js +191 -0
  202. package/dist/fanout/picker.d.ts +91 -0
  203. package/dist/fanout/picker.js +51 -0
  204. package/dist/fanout/usage.d.ts +5 -0
  205. package/dist/fanout/usage.js +51 -0
  206. package/dist/fanout/watchdog.d.ts +10 -0
  207. package/dist/fanout/watchdog.js +27 -0
  208. package/dist/filenames.d.ts +9 -0
  209. package/dist/filenames.js +11 -0
  210. package/dist/finding/context.js +4 -22
  211. package/dist/generated/memory-ui-graph.browser.js +279 -283
  212. package/dist/governance/policy-constants.d.ts +11 -0
  213. package/dist/governance/policy-constants.js +9 -0
  214. package/dist/governance/policy.d.ts +5 -8
  215. package/dist/governance/policy.js +7 -5
  216. package/dist/graph-core/camera.d.ts +24 -0
  217. package/dist/graph-core/camera.js +18 -0
  218. package/dist/graph-core/index.d.ts +2 -0
  219. package/dist/graph-core/index.js +2 -0
  220. package/dist/graph-core/labels.d.ts +77 -0
  221. package/dist/graph-core/labels.js +124 -0
  222. package/dist/graph-core/model.d.ts +13 -0
  223. package/dist/graph-core/model.js +33 -0
  224. package/dist/graph-core/types.d.ts +2 -0
  225. package/dist/home-paths.d.ts +7 -0
  226. package/dist/home-paths.js +21 -0
  227. package/dist/hooks.d.ts +3 -0
  228. package/dist/hooks.js +13 -0
  229. package/dist/index.js +24 -2
  230. package/dist/init/guard-globals.d.ts +1 -1
  231. package/dist/init/guard-globals.js +4 -4
  232. package/dist/init/init-configure.js +3 -3
  233. package/dist/init/init-uninstall.js +2 -2
  234. package/dist/init/init-walkthrough.d.ts +2 -0
  235. package/dist/init/init-walkthrough.js +17 -6
  236. package/dist/init/init.js +26 -6
  237. package/dist/init/management-preset.d.ts +1 -1
  238. package/dist/init/management-preset.js +2 -2
  239. package/dist/init/preferences.js +1 -1
  240. package/dist/init/self-wiring.js +1 -1
  241. package/dist/init/setup.d.ts +3 -26
  242. package/dist/init/setup.js +49 -588
  243. package/dist/init/shared.js +2 -0
  244. package/dist/init/store-gitignore.d.ts +1 -1
  245. package/dist/init/store-gitignore.js +2 -0
  246. package/dist/init/teardown.d.ts +1 -1
  247. package/dist/init/teardown.js +2 -2
  248. package/dist/link/context.js +1 -1
  249. package/dist/link/doctor.d.ts +22 -1
  250. package/dist/link/doctor.js +100 -54
  251. package/dist/link/link.js +29 -61
  252. package/dist/link/refresh.js +2 -2
  253. package/dist/link/skills.js +26 -5
  254. package/dist/machine-identity.d.ts +3 -0
  255. package/dist/machine-identity.js +6 -0
  256. package/dist/mcp/profile.d.ts +2 -15
  257. package/dist/mcp/profile.js +64 -9
  258. package/dist/memory-ui-graph.runtime.js +279 -283
  259. package/dist/modules/code-package.d.ts +16 -0
  260. package/dist/modules/code-package.js +152 -0
  261. package/dist/modules/command.d.ts +2 -0
  262. package/dist/modules/command.js +67 -0
  263. package/dist/modules/config.d.ts +4 -0
  264. package/dist/modules/config.js +70 -0
  265. package/dist/modules/manifest.d.ts +41 -0
  266. package/dist/modules/manifest.js +1 -0
  267. package/dist/modules/provision.d.ts +3 -0
  268. package/dist/modules/provision.js +84 -0
  269. package/dist/modules/registry.d.ts +16 -0
  270. package/dist/modules/registry.js +250 -0
  271. package/dist/modules/runtime.d.ts +15 -0
  272. package/dist/modules/runtime.js +59 -0
  273. package/dist/package-metadata.js +10 -2
  274. package/dist/phren-dotenv.js +4 -2
  275. package/dist/phren-paths.d.ts +3 -2
  276. package/dist/phren-paths.js +4 -5
  277. package/dist/profile-store.js +4 -5
  278. package/dist/project-config.d.ts +19 -1
  279. package/dist/project-config.js +29 -3
  280. package/dist/project-topics.js +4 -4
  281. package/dist/provider-adapters.js +1 -4
  282. package/dist/query-correlation.js +6 -6
  283. package/dist/session/artifacts.js +5 -5
  284. package/dist/session/checkpoints.js +5 -0
  285. package/dist/session/utils.d.ts +2 -2
  286. package/dist/session/utils.js +6 -6
  287. package/dist/shared/content.d.ts +1 -1
  288. package/dist/shared/content.js +1 -1
  289. package/dist/shared/data-utils.js +1 -1
  290. package/dist/shared/fragment-graph.d.ts +1 -1
  291. package/dist/shared/fragment-graph.js +5 -5
  292. package/dist/shared/index.js +48 -7
  293. package/dist/shared/retrieval.d.ts +18 -1
  294. package/dist/shared/retrieval.js +100 -11
  295. package/dist/shared/search-fallback.js +4 -6
  296. package/dist/shared/sqljs.d.ts +2 -0
  297. package/dist/shared/sqljs.js +4 -2
  298. package/dist/shared.d.ts +0 -1
  299. package/dist/shared.js +0 -1
  300. package/dist/shell/input.d.ts +1 -5
  301. package/dist/shell/input.js +16 -10
  302. package/dist/shell/palette.d.ts +2 -2
  303. package/dist/shell/palette.js +3 -7
  304. package/dist/shell/render.d.ts +3 -1
  305. package/dist/shell/render.js +4 -4
  306. package/dist/shell/shell.js +4 -1
  307. package/dist/shell/types.d.ts +1 -0
  308. package/dist/shell/types.js +4 -0
  309. package/dist/shell/view.d.ts +0 -4
  310. package/dist/shell/view.js +19 -27
  311. package/dist/skill/registry.js +25 -17
  312. package/dist/skill/state.d.ts +3 -0
  313. package/dist/skill/state.js +13 -7
  314. package/dist/status.js +38 -17
  315. package/dist/store-registry.d.ts +44 -18
  316. package/dist/store-registry.js +169 -60
  317. package/dist/store-weight.d.ts +1 -6
  318. package/dist/store-weight.js +4 -2
  319. package/dist/sync/auth-doctor.d.ts +8 -0
  320. package/dist/sync/auth-doctor.js +27 -0
  321. package/dist/sync/auth.d.ts +27 -0
  322. package/dist/sync/auth.js +114 -0
  323. package/dist/sync/conflict-resolve.d.ts +9 -0
  324. package/dist/sync/conflict-resolve.js +146 -0
  325. package/dist/sync/git-state.d.ts +4 -0
  326. package/dist/sync/git-state.js +49 -0
  327. package/dist/sync/outcome.d.ts +34 -0
  328. package/dist/sync/outcome.js +57 -0
  329. package/dist/sync/pull.d.ts +15 -7
  330. package/dist/sync/pull.js +84 -35
  331. package/dist/sync/store-merge.d.ts +29 -0
  332. package/dist/sync/store-merge.js +137 -0
  333. package/dist/sync/task-merge.d.ts +22 -0
  334. package/dist/sync/task-merge.js +158 -0
  335. package/dist/task/github.js +1 -1
  336. package/dist/task/lifecycle.d.ts +5 -0
  337. package/dist/task/lifecycle.js +67 -23
  338. package/dist/terminal-text.d.ts +5 -0
  339. package/dist/terminal-text.js +11 -0
  340. package/dist/test-global-setup.js +7 -0
  341. package/dist/tool-registry.d.ts +1 -1
  342. package/dist/tool-registry.js +3 -1
  343. package/dist/tools/code.d.ts +3 -0
  344. package/dist/tools/code.js +178 -0
  345. package/dist/tools/config.js +5 -0
  346. package/dist/tools/data.js +14 -7
  347. package/dist/tools/dispatch.d.ts +2 -0
  348. package/dist/tools/dispatch.js +66 -0
  349. package/dist/tools/finding.js +43 -41
  350. package/dist/tools/ops.js +5 -2
  351. package/dist/tools/search.js +21 -8
  352. package/dist/tools/session.js +21 -22
  353. package/dist/tools/tasks.js +8 -2
  354. package/dist/tools/types.d.ts +2 -2
  355. package/dist/tools/types.js +2 -2
  356. package/dist/ui/assets.js +1 -1
  357. package/dist/ui/data.js +14 -15
  358. package/dist/ui/deep-void.d.ts +1 -1
  359. package/dist/ui/deep-void.js +0 -1
  360. package/dist/ui/graph-chrome.d.ts +1 -1
  361. package/dist/ui/graph-chrome.js +51 -0
  362. package/dist/ui/page.js +5 -5
  363. package/dist/ui/scripts.js +67 -30
  364. package/dist/ui/server.js +34 -6
  365. package/dist/update.js +1 -1
  366. package/dist/utils-fts.js +1 -0
  367. package/dist/utils-helpers.d.ts +7 -0
  368. package/dist/utils-helpers.js +17 -0
  369. package/dist/utils.d.ts +1 -1
  370. package/dist/utils.js +1 -1
  371. package/package.json +45 -3
  372. package/plugins/opencode/phren-transcript.js +340 -0
  373. package/starter/README.md +4 -4
  374. package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
  375. package/starter/global/skills/conductor/SKILL.md +106 -0
  376. package/starter/global/skills/fanout/SKILL.md +20 -0
  377. package/starter/global/skills/phren-discover/SKILL.md +6 -6
  378. package/starter/global/skills/phren-init/SKILL.md +4 -4
  379. package/starter/global/skills/phren-sync/SKILL.md +3 -3
  380. package/starter/templates/frontend/reference/README.md +1 -1
  381. package/starter/templates/library/reference/README.md +1 -1
  382. package/starter/templates/monorepo/reference/README.md +1 -1
  383. package/starter/templates/python-project/reference/README.md +1 -1
  384. /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
  385. /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
  386. /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
  387. /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
@@ -0,0 +1,106 @@
1
+ ---
2
+ name: conductor
3
+ description: Coordinate independent Phren tasks across every project in the store and every enrolled computer, supervise their local agent fanout, and integrate verified returns in a concise dispatcher voice.
4
+ ---
5
+
6
+ # Conductor
7
+
8
+ You are the owner's dispatcher for the whole store, not one project. You start
9
+ in the phren store itself; that folder is not a project and not your work.
10
+
11
+ First, before trusting your tools, check which phren you are running:
12
+ `phren --version` and `command -v phren`. If the version is older than the one
13
+ the store or the owner expects, or the path is not the install you expect (a
14
+ stale global package, an old checkout), tell the owner in one line and say
15
+ which tools may be missing or behave differently.
16
+
17
+ Then read the relevant projects' summaries and Phren tasks
18
+ (`get_project_summary`, `get_tasks`) before selecting work.
19
+
20
+ Your tools, use these instead of exploring the CLI or the Hook's files:
21
+
22
+ - `live_sessions` (CLI `phren dispatch sessions`): every live agent on this
23
+ computer and each enrolled one, with project, harness, status, `idleFor`
24
+ (seconds since it last changed) and the target `hand_off` takes. Start here
25
+ when asked what is running. Computers it could not reach are listed; say so
26
+ rather than guessing. Computers in `notLinked` are registered in the store
27
+ but have no Hook link here: say they were not checked, never that nothing is
28
+ running there.
29
+ - `hand_off`: send a prompt to one of those sessions.
30
+ - `dispatch`: start a new worker on a computer (or `anywhere`).
31
+ - `dispatch_returns` (CLI `phren dispatch returns`): what your workers sent
32
+ back since you last asked: done with the final reply, needs-you with the
33
+ question, blocked, or gone. Reading them marks them read. In core use
34
+ `phren_admin(action: "dispatch_returns")`.
35
+ - `phren dispatch status`: receipts of what you dispatched.
36
+ - `get_tasks`, `get_project_summary`, `search_knowledge`: the store's memory.
37
+
38
+ Keep
39
+ engineering detail in worker briefs and review artifacts. In the owner's chat,
40
+ write one short line per dispatch and one per return:
41
+
42
+ ```text
43
+ Linuxbox: parser checks sent to Codex (configured default); report due 14:20 PT.
44
+ Desk: navigation checks returned; tests passed; not merged.
45
+ ```
46
+
47
+ Include computer, brief, harness/model, and the next expected report time on a
48
+ dispatch. Include who finished what, test result and merged/not merged on a
49
+ return. If a result or deadline is unknown, say so. Surface questions in the same
50
+ short voice with the worker's choices; do not turn the chat into code commentary.
51
+
52
+ Pick five to ten independent tasks when that many are available and capacity
53
+ permits. Do not manufacture tasks to fill the batch. Separate dependencies and
54
+ file ownership; give each remote lead a base revision, acceptance checks, local
55
+ fanout limit, report time and integration instructions. Every brief repeats the
56
+ owner's repository constraints, including any prohibition on commits, pushes,
57
+ branches or particular tests. Dispatch never expands the owner's authorization.
58
+
59
+ Prefer Codex. Use OpenCode Go when its account and harness are connected. Use
60
+ OpenRouter only when the owner explicitly requests it; an unavailable account
61
+ does not authorize another paid provider. Name an explicit model when instructed,
62
+ otherwise use and report the remote configured default. Each remote lead owns
63
+ its local checkouts, fanout and provider rate limits. Where installed, local
64
+ workers use the fanout wrapper's `scripts/run.sh --provider codex|opencode
65
+ --label --worktree [--model] [--mode]` contract and parent-bound manifests.
66
+
67
+ Prefer handing work to a session that already owns the project and is idle or
68
+ doing related work; call `hand_off` in full or `phren_admin(action: "hand_off",
69
+ computer?, target|session, text)` in core. Otherwise dispatch a new worker.
70
+ Write one short line either way. Call `dispatch` in full or
71
+ `phren_admin(action: "dispatch", computer, project, harness, model?, prompt, label)`
72
+ in core. The CLI equivalent is `phren dispatch <computer|anywhere> <project>
73
+ --harness <harness> --label <label> --prompt <brief> [--model <model>]`.
74
+ `anywhere` chooses the connected computer with the fewest working agents. Place
75
+ briefs sequentially, respecting busy/rate-limit responses. Keep their dispatch
76
+ IDs. Do not send local filesystem paths as remote project names.
77
+
78
+ `accepted` on a receipt is prompt acceptance, not worker completion. Returns
79
+ arrive on their own: the Hook follows every worker you dispatch, and when you
80
+ are idle it types one line into this session, such as `Return: Linuxbox parser
81
+ checks done, tests passed (dispatch <id>). Call dispatch_returns.` When you see
82
+ one, call `dispatch_returns` and report each return in one short line. You may
83
+ also call it whenever you want the current state; do not poll it in a loop, and
84
+ do not read remote transcripts by hand to learn whether a worker finished. Tell
85
+ the owner a return time as an expectation, not a promise.
86
+
87
+ For a `needs-you` return, surface the worker's question in the owner's chat
88
+ with its choices as the worker wrote them; do not rewrite or answer it for the
89
+ owner unless the owner already decided. Send the answer back with `hand_off`
90
+ to the row's `target`. A `blocked` worker waits on terminal input, such as a
91
+ permission prompt: say so and point the owner to the phone or the terminal. A
92
+ `gone` worker's pane closed or was taken over: say so, and decide with the
93
+ owner before giving its work to another agent. A `done` reply is the worker's
94
+ own account; check its evidence before saying tests passed or work merged.
95
+
96
+ An uncertain delivery is never retried automatically. Inspect its known target
97
+ or status before deciding with the owner whether a replacement is needed. Keep
98
+ unavailable workers visible instead of giving their work to another agent
99
+ while the original may still be running.
100
+
101
+ Integrate returned changes in dependency order within the owner's allowed
102
+ workflow. Run a cleanup pass across the combined result and the affected checks.
103
+ Require evidence before saying tests passed or merged. Ship only within existing
104
+ authorization; if publication is not authorized, return the reviewable result.
105
+ Update Phren tasks when verified complete and save durable decisions. A worker's
106
+ finished turn alone does not complete the owner's task.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: fanout
3
+ description: Delegate independent, bounded implementation or review work to headless agent workers using phren fanout.
4
+ ---
5
+
6
+ Fan out when independent tasks can make progress alongside the lead's work.
7
+ Give each writer a separate worktree and a concrete output to validate. A brief
8
+ should name the goal, owned files, constraints, tests, and completion report.
9
+ Include relevant findings and exact review issues; avoid sending the whole chat.
10
+
11
+ Enable Hook and fanout, then use `phren fanout run --tier narrow|wide|review
12
+ --label LABEL --worktree PATH < brief.txt`. The command chooses an eligible
13
+ provider using current usage, errors and concurrency. Use `phren fanout usage`
14
+ to inspect it, and `--provider`/`--model` for an explicit choice subject to caps.
15
+
16
+ Use `phren fanout list` to inspect jobs, `phren fanout resume JOB < feedback.txt`
17
+ to send a bounded follow-up, and `phren fanout review JOB` for a review round.
18
+ Codex resumes inherit their original sandbox; ask a resumed author to review
19
+ without edits. Use a fresh review-tier worker for an enforced read-only sandbox.
20
+ Archive completed jobs with `phren fanout archive`.
@@ -41,7 +41,7 @@ for dir in "$PHREN_DIR"/*/; do
41
41
  PROJECT=$(basename "$dir")
42
42
  [ "$PROJECT" = "global" ] || [ "$PROJECT" = "profiles" ] && continue
43
43
 
44
- [ -f "$dir/CLAUDE.md" ] && echo "$PROJECT: has CLAUDE.md" || echo "$PROJECT: MISSING CLAUDE.md"
44
+ [ -f "$dir/AGENTS.md" ] && echo "$PROJECT: has AGENTS.md" || echo "$PROJECT: MISSING AGENTS.md"
45
45
  [ -f "$dir/summary.md" ] && echo "$PROJECT: has summary.md" || echo "$PROJECT: MISSING summary.md"
46
46
  [ -f "$dir/FINDINGS.md" ] && echo "$PROJECT: has FINDINGS.md" || echo "$PROJECT: MISSING FINDINGS.md"
47
47
  [ -f "$dir/tasks.md" ] && echo "$PROJECT: has tasks.md" || echo "$PROJECT: MISSING tasks.md"
@@ -63,9 +63,9 @@ for dir in */; do
63
63
  echo "$PROJECT/FINDINGS.md: last updated $LAST_MODIFIED"
64
64
  fi
65
65
 
66
- if [ -f "$dir/CLAUDE.md" ]; then
67
- LAST_MODIFIED=$(git log -1 --format="%cr" -- "$dir/CLAUDE.md" 2>/dev/null || stat -c %Y "$dir/CLAUDE.md" 2>/dev/null || stat -f %m "$dir/CLAUDE.md" 2>/dev/null)
68
- echo "$PROJECT/CLAUDE.md: last updated $LAST_MODIFIED"
66
+ if [ -f "$dir/AGENTS.md" ]; then
67
+ LAST_MODIFIED=$(git log -1 --format="%cr" -- "$dir/AGENTS.md" 2>/dev/null || stat -c %Y "$dir/AGENTS.md" 2>/dev/null || stat -f %m "$dir/AGENTS.md" 2>/dev/null)
68
+ echo "$PROJECT/AGENTS.md: last updated $LAST_MODIFIED"
69
69
  fi
70
70
  done
71
71
  ```
@@ -121,7 +121,7 @@ phren-discover
121
121
 
122
122
  Projects without core files:
123
123
 
124
- | Project | CLAUDE.md | summary.md | FINDINGS.md | tasks.md |
124
+ | Project | AGENTS.md | summary.md | FINDINGS.md | tasks.md |
125
125
  |---------|-----------|------------|--------------|------------|
126
126
  | myapp | ok | MISSING | MISSING | ok |
127
127
  | api | ok | ok | ok | MISSING |
@@ -130,7 +130,7 @@ Projects without core files:
130
130
 
131
131
  Files not updated in 30+ days:
132
132
  - my-app/FINDINGS.md: last updated 45 days ago
133
- - frontend/CLAUDE.md: last updated 62 days ago
133
+ - frontend/AGENTS.md: last updated 62 days ago
134
134
 
135
135
  ## Section 3: Skill gaps
136
136
 
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: phren-init
3
- description: Set up a new project in phren with summary, CLAUDE.md, task, and skill templates.
3
+ description: Set up a new project in phren with summary, AGENTS.md, task, and skill templates.
4
4
  dependencies:
5
5
  - git
6
6
  ---
7
7
  # phren-init - Scaffold a new project
8
8
 
9
- > Set up a new project in phren with summary, CLAUDE.md, task, and skill templates.
9
+ > Set up a new project in phren with summary, AGENTS.md, task, and skill templates.
10
10
 
11
11
  Add a new project to your phren instance, or bootstrap phren itself if you're starting fresh.
12
12
 
@@ -68,7 +68,7 @@ Watch out: <the one thing that trips people up>
68
68
 
69
69
  Ask the user for these if you can't figure them out from the project directory. If the project directory exists on disk (e.g. `~/<project-name>/`), read its package.json, pyproject.toml, README, or similar to pre-fill.
70
70
 
71
- ### 4. Create CLAUDE.md
71
+ ### 4. Create AGENTS.md
72
72
 
73
73
  ```markdown
74
74
  # <project-name>
@@ -177,7 +177,7 @@ phren-init <project-name>
177
177
 
178
178
  Created:
179
179
  $PHREN_DIR/<project-name>/summary.md
180
- $PHREN_DIR/<project-name>/CLAUDE.md
180
+ $PHREN_DIR/<project-name>/AGENTS.md
181
181
  $PHREN_DIR/<project-name>/tasks.md
182
182
  $PHREN_DIR/<project-name>/skills/README.md
183
183
 
@@ -11,7 +11,7 @@ phren's store is a git repo (`~/.phren`, or `$PHREN_PATH`) that syncs across mac
11
11
  ## Pull (new machine, or "sync my config")
12
12
 
13
13
  ```bash
14
- git -C ~/.phren pull --rebase # or on a new machine: git clone <store-url> ~/.phren
14
+ phren store sync # or on a new machine: git clone <store-url> ~/.phren
15
15
  phren profile switch <profile> # maps this machine (hostname) to a profile in machines.yaml
16
16
  phren init -y # wires MCP, hooks, skill mirrors, project links for that profile
17
17
  phren doctor # anything still red is either a repo not cloned here or a team store to join
@@ -21,7 +21,7 @@ If `machines.yaml` has no entry for this machine, ask which profile to use (`ls
21
21
 
22
22
  ## Push ("save this to my phren", "sync back")
23
23
 
24
- Store files are the linked originals, so edits made through `~/.claude/skills/*` or a project's `CLAUDE.md` are already in the store. Commit and push from there:
24
+ Store files are the linked originals, so edits made through `~/.claude/skills/*` or a project's `AGENTS.md` are already in the store. Commit and push from there:
25
25
 
26
26
  ```bash
27
27
  git -C ~/.phren add -A && git -C ~/.phren commit -m "<what changed> from $(hostname)" && git -C ~/.phren push
@@ -31,7 +31,7 @@ The stop hook auto-saves too; a manual push is only for "I want it on the other
31
31
 
32
32
  ## Conflicts
33
33
 
34
- `git pull --rebase` may conflict when two machines edited the same file. `tasks.md` and `FINDINGS.md`: keep both sides. `CLAUDE.md` and skills: show the user both and let them choose. Never drop a side silently.
34
+ `phren store sync` union-merges conflicts in `tasks.md`, `FINDINGS.md`, and task archives. For other conflicts, it aborts the merge and reports the paths for manual resolution. Never drop a side silently.
35
35
 
36
36
  ## Related
37
37
 
@@ -1,4 +1,4 @@
1
1
  # {{project}} Reference
2
2
 
3
3
  Deep reference material: API details, data models, integration specs.
4
- Too long for CLAUDE.md? Put it here. Phren indexes these files automatically.
4
+ Too long for AGENTS.md? Put it here. Phren indexes these files automatically.
@@ -1,4 +1,4 @@
1
1
  # {{project}} Reference
2
2
 
3
3
  Deep reference material: API details, data models, integration specs.
4
- Too long for CLAUDE.md? Put it here. Phren indexes these files automatically.
4
+ Too long for AGENTS.md? Put it here. Phren indexes these files automatically.
@@ -1,4 +1,4 @@
1
1
  # {{project}} Reference
2
2
 
3
3
  Deep reference material: API details, data models, integration specs.
4
- Too long for CLAUDE.md? Put it here. Phren indexes these files automatically.
4
+ Too long for AGENTS.md? Put it here. Phren indexes these files automatically.
@@ -1,4 +1,4 @@
1
1
  # {{project}} Reference
2
2
 
3
3
  Deep reference material: API details, data models, integration specs.
4
- Too long for CLAUDE.md? Put it here. Phren indexes these files automatically.
4
+ Too long for AGENTS.md? Put it here. Phren indexes these files automatically.