tenjin-cli 0.1.0-alpha.15 → 0.1.0-alpha.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 (267) hide show
  1. package/NOTICE.md +54 -7
  2. package/README.md +41 -310
  3. package/dist/{_esm-N4KAVXQR.js → _esm-CE7KNONL.js} +9 -10
  4. package/dist/{ccip-ZGGWQN4X.js → ccip-7RMRLAGV.js} +4 -4
  5. package/dist/{ccip-RPPPKTJR.js → ccip-NLCSCHKI.js} +5 -5
  6. package/dist/chunk-25TJPVBF.js +353 -0
  7. package/dist/chunk-25TJPVBF.js.map +1 -0
  8. package/dist/chunk-2BKS2FVE.js +93 -0
  9. package/dist/chunk-2BKS2FVE.js.map +1 -0
  10. package/dist/chunk-2QYORQBF.js +55 -0
  11. package/dist/chunk-2QYORQBF.js.map +1 -0
  12. package/dist/{chunk-NIKXHWOL.js → chunk-2U5ZVEV3.js} +16 -16
  13. package/dist/chunk-2U5ZVEV3.js.map +1 -0
  14. package/dist/{chunk-HPJGOLTN.js → chunk-3AJS6LLN.js} +13 -8
  15. package/dist/chunk-3AJS6LLN.js.map +1 -0
  16. package/dist/{chunk-KINZ23CV.js → chunk-3AUDA53C.js} +4740 -23
  17. package/dist/chunk-3AUDA53C.js.map +1 -0
  18. package/dist/{chunk-MJZZTKCC.js → chunk-56MOAIP5.js} +5 -10
  19. package/dist/chunk-56MOAIP5.js.map +1 -0
  20. package/dist/{chunk-U5S527PP.js → chunk-5IEP5EGE.js} +3 -3
  21. package/dist/chunk-5X4SZ5BF.js +227 -0
  22. package/dist/chunk-5X4SZ5BF.js.map +1 -0
  23. package/dist/chunk-7WEQQJLG.js +68 -0
  24. package/dist/chunk-7WEQQJLG.js.map +1 -0
  25. package/dist/{chunk-7FK2UN2T.js → chunk-AWQPGIR6.js} +65 -67
  26. package/dist/{chunk-7FK2UN2T.js.map → chunk-AWQPGIR6.js.map} +1 -1
  27. package/dist/{chunk-ZFJJ3EXC.js → chunk-BBVUVBUO.js} +516 -185
  28. package/dist/chunk-BBVUVBUO.js.map +1 -0
  29. package/dist/{chunk-JBIKAAT3.js → chunk-BFFM2WFK.js} +8 -8
  30. package/dist/chunk-BFFM2WFK.js.map +1 -0
  31. package/dist/{chunk-KYQVEKP5.js → chunk-BPMWXTFX.js} +8 -8
  32. package/dist/chunk-DMZZLPZN.js +205 -0
  33. package/dist/chunk-DMZZLPZN.js.map +1 -0
  34. package/dist/{chunk-47PP7TAG.js → chunk-EGELTSPU.js} +1356 -1356
  35. package/dist/chunk-EGELTSPU.js.map +1 -0
  36. package/dist/chunk-GULLJQXA.js +698 -0
  37. package/dist/chunk-GULLJQXA.js.map +1 -0
  38. package/dist/{chunk-S5RYMCV6.js → chunk-HPWO4O6S.js} +3 -3
  39. package/dist/chunk-HVRC33OL.js +174 -0
  40. package/dist/chunk-HVRC33OL.js.map +1 -0
  41. package/dist/{chunk-W6R3HAAG.js → chunk-JRGFKVAZ.js} +2 -2
  42. package/dist/{chunk-XJN5WUKL.js → chunk-KG3D7FIF.js} +2 -2
  43. package/dist/chunk-L3PVMIYQ.js +10328 -0
  44. package/dist/chunk-L3PVMIYQ.js.map +1 -0
  45. package/dist/{chunk-QW2Q2KAH.js → chunk-LHHMV4GU.js} +2 -2
  46. package/dist/{chunk-ZOBNS7CX.js → chunk-MEFB5KHA.js} +4 -18
  47. package/dist/chunk-MEFB5KHA.js.map +1 -0
  48. package/dist/{chunk-M2O56UK7.js → chunk-N35E6CM2.js} +293 -163
  49. package/dist/chunk-N35E6CM2.js.map +1 -0
  50. package/dist/chunk-OCBHUHWB.js +69 -0
  51. package/dist/chunk-OCBHUHWB.js.map +1 -0
  52. package/dist/chunk-OIM4HLN6.js +1405 -0
  53. package/dist/chunk-OIM4HLN6.js.map +1 -0
  54. package/dist/{chunk-VYOJOX4Z.js → chunk-OJLYNM4Z.js} +54 -33
  55. package/dist/chunk-OJLYNM4Z.js.map +1 -0
  56. package/dist/{chunk-POJRB2AE.js → chunk-POUWHWID.js} +2 -2
  57. package/dist/chunk-PZEN5PHN.js +285 -0
  58. package/dist/chunk-PZEN5PHN.js.map +1 -0
  59. package/dist/chunk-SKAHDQH7.js +1785 -0
  60. package/dist/chunk-SKAHDQH7.js.map +1 -0
  61. package/dist/{chunk-KZAAWQNP.js → chunk-TTNESUPQ.js} +3 -3
  62. package/dist/chunk-U5DXNFJC.js +137 -0
  63. package/dist/chunk-U5DXNFJC.js.map +1 -0
  64. package/dist/chunk-USS336NF.js +165 -0
  65. package/dist/chunk-USS336NF.js.map +1 -0
  66. package/dist/{chunk-UO22YNY4.js → chunk-WH7OWT6G.js} +49 -1
  67. package/dist/chunk-WH7OWT6G.js.map +1 -0
  68. package/dist/chunk-WXC57XGG.js +29 -0
  69. package/dist/chunk-WXC57XGG.js.map +1 -0
  70. package/dist/{chunk-YLYINX2H.js → chunk-XZKD7DIF.js} +3 -3
  71. package/dist/{chunk-CPCX67TI.js → chunk-YEETV6IW.js} +1079 -1039
  72. package/dist/chunk-YEETV6IW.js.map +1 -0
  73. package/dist/{chunk-OLWTRUTS.js → chunk-YJHHCWM3.js} +35 -16
  74. package/dist/chunk-YJHHCWM3.js.map +1 -0
  75. package/dist/{cli-KKRKBU5T.js → cli-M3XCSOU6.js} +289 -374
  76. package/dist/cli-M3XCSOU6.js.map +1 -0
  77. package/dist/config-MXOX7XDR.js +41 -0
  78. package/dist/{dist-U4M6QCKE.js → dist-3LOO6M4U.js} +10 -10
  79. package/dist/doctor-LU4YIZWM.js +349 -0
  80. package/dist/doctor-LU4YIZWM.js.map +1 -0
  81. package/dist/{ethersCompat-Df4a6QIZ-WHYKB6HA.js → ethersCompat-Df4a6QIZ-THAVUGIJ.js} +5 -5
  82. package/dist/{chunk-KAJZHIQ4.js → fund-A54P2QFK.js} +80 -24
  83. package/dist/fund-A54P2QFK.js.map +1 -0
  84. package/dist/hook-command-U6KWPEDQ.js +377 -0
  85. package/dist/hook-command-U6KWPEDQ.js.map +1 -0
  86. package/dist/index.js +8 -3
  87. package/dist/index.js.map +1 -1
  88. package/dist/install-XUM2XSHW.js +53 -0
  89. package/dist/install-wallet-QIOFORTX.js +105 -0
  90. package/dist/install-wallet-QIOFORTX.js.map +1 -0
  91. package/dist/{run-XYTQ5TWQ.js → mcp-HJC2PLRV.js} +3727 -10670
  92. package/dist/mcp-HJC2PLRV.js.map +1 -0
  93. package/dist/paths-P2N4JTDZ.js +49 -0
  94. package/dist/pay-SBXZEPEP.js +37 -0
  95. package/dist/redact-46ZHF2NH.js +17 -0
  96. package/dist/{secp256k1-XRPVBC6V.js → secp256k1-ZZZT2CAX.js} +3 -3
  97. package/dist/{send-G746D7PQ.js → send-ASD2ZXJD.js} +28 -29
  98. package/dist/send-ASD2ZXJD.js.map +1 -0
  99. package/dist/{chunk-QZ6ROAJU.js → skill-placement-NFVHY6A3.js} +157 -11
  100. package/dist/skill-placement-NFVHY6A3.js.map +1 -0
  101. package/dist/status-T2SDB57A.js +63 -0
  102. package/dist/status-T2SDB57A.js.map +1 -0
  103. package/dist/status-line-CGPUSDMC.js +71 -0
  104. package/dist/status-line-CGPUSDMC.js.map +1 -0
  105. package/dist/status-line-wiring-BYPHTYZE.js +30 -0
  106. package/dist/tenjin-daemon.mjs +20060 -0
  107. package/dist/tenjin-shim.mjs +251 -0
  108. package/dist/tenjin-vitest-reporter.mjs +49 -0
  109. package/dist/uninstall-FKYZHAM3.js +144 -0
  110. package/dist/uninstall-FKYZHAM3.js.map +1 -0
  111. package/dist/{update-R76LHOZW.js → update-ANJ2AOTN.js} +133 -16
  112. package/dist/update-ANJ2AOTN.js.map +1 -0
  113. package/dist/{viemAdapter-By13KInL-TUQJBMHM.js → viemAdapter-By13KInL-X2VY6CY3.js} +5 -5
  114. package/dist/wallet-PWAHVKWW.js +31 -0
  115. package/dist/wallet-kdf-worker.mjs +980 -0
  116. package/docs/agent-permissions.md +65 -354
  117. package/docs/safety-model.md +16 -6
  118. package/package.json +8 -7
  119. package/LICENSE +0 -21
  120. package/dist/buy-VIRNSYGN.js +0 -47
  121. package/dist/chunk-2MYQN7HM.js +0 -247
  122. package/dist/chunk-2MYQN7HM.js.map +0 -1
  123. package/dist/chunk-2RF2GIJQ.js +0 -1188
  124. package/dist/chunk-2RF2GIJQ.js.map +0 -1
  125. package/dist/chunk-3GL2Z5QK.js +0 -57
  126. package/dist/chunk-3GL2Z5QK.js.map +0 -1
  127. package/dist/chunk-47PP7TAG.js.map +0 -1
  128. package/dist/chunk-4CQIDQOT.js +0 -167
  129. package/dist/chunk-4CQIDQOT.js.map +0 -1
  130. package/dist/chunk-4KG27W2S.js +0 -614
  131. package/dist/chunk-4KG27W2S.js.map +0 -1
  132. package/dist/chunk-5QQTYWEU.js +0 -199
  133. package/dist/chunk-5QQTYWEU.js.map +0 -1
  134. package/dist/chunk-65DTCCJ7.js +0 -21
  135. package/dist/chunk-65DTCCJ7.js.map +0 -1
  136. package/dist/chunk-A5DKHMUN.js +0 -173
  137. package/dist/chunk-A5DKHMUN.js.map +0 -1
  138. package/dist/chunk-B63XPWQ4.js +0 -246
  139. package/dist/chunk-B63XPWQ4.js.map +0 -1
  140. package/dist/chunk-CAR6FHK6.js +0 -105
  141. package/dist/chunk-CAR6FHK6.js.map +0 -1
  142. package/dist/chunk-CPCX67TI.js.map +0 -1
  143. package/dist/chunk-CQBVCYI2.js +0 -162
  144. package/dist/chunk-CQBVCYI2.js.map +0 -1
  145. package/dist/chunk-DBU5CXBV.js +0 -4731
  146. package/dist/chunk-DBU5CXBV.js.map +0 -1
  147. package/dist/chunk-DHJD77OW.js +0 -81
  148. package/dist/chunk-DHJD77OW.js.map +0 -1
  149. package/dist/chunk-EDZSNPE5.js +0 -35
  150. package/dist/chunk-EDZSNPE5.js.map +0 -1
  151. package/dist/chunk-EFWZPUTC.js +0 -65
  152. package/dist/chunk-EFWZPUTC.js.map +0 -1
  153. package/dist/chunk-EPFL6CTE.js +0 -448
  154. package/dist/chunk-EPFL6CTE.js.map +0 -1
  155. package/dist/chunk-GHLVXVZD.js +0 -142
  156. package/dist/chunk-GHLVXVZD.js.map +0 -1
  157. package/dist/chunk-H3SOOJ2I.js +0 -580
  158. package/dist/chunk-H3SOOJ2I.js.map +0 -1
  159. package/dist/chunk-HPJGOLTN.js.map +0 -1
  160. package/dist/chunk-HRGBS2PA.js +0 -203
  161. package/dist/chunk-HRGBS2PA.js.map +0 -1
  162. package/dist/chunk-ITUXPJIS.js +0 -314
  163. package/dist/chunk-ITUXPJIS.js.map +0 -1
  164. package/dist/chunk-JBIKAAT3.js.map +0 -1
  165. package/dist/chunk-KAJZHIQ4.js.map +0 -1
  166. package/dist/chunk-KINZ23CV.js.map +0 -1
  167. package/dist/chunk-LRYV3SK7.js +0 -235
  168. package/dist/chunk-LRYV3SK7.js.map +0 -1
  169. package/dist/chunk-M2O56UK7.js.map +0 -1
  170. package/dist/chunk-MJZZTKCC.js.map +0 -1
  171. package/dist/chunk-NIKXHWOL.js.map +0 -1
  172. package/dist/chunk-OKDRDT74.js +0 -209
  173. package/dist/chunk-OKDRDT74.js.map +0 -1
  174. package/dist/chunk-OKYSNAS3.js +0 -2144
  175. package/dist/chunk-OKYSNAS3.js.map +0 -1
  176. package/dist/chunk-OLWTRUTS.js.map +0 -1
  177. package/dist/chunk-QQ6ELLSA.js +0 -143
  178. package/dist/chunk-QQ6ELLSA.js.map +0 -1
  179. package/dist/chunk-QZ6ROAJU.js.map +0 -1
  180. package/dist/chunk-R7RSCBI7.js +0 -794
  181. package/dist/chunk-R7RSCBI7.js.map +0 -1
  182. package/dist/chunk-SGK2B724.js +0 -67
  183. package/dist/chunk-SGK2B724.js.map +0 -1
  184. package/dist/chunk-U6VPKMGC.js +0 -390
  185. package/dist/chunk-U6VPKMGC.js.map +0 -1
  186. package/dist/chunk-UHTVXQ2O.js +0 -140
  187. package/dist/chunk-UHTVXQ2O.js.map +0 -1
  188. package/dist/chunk-UO22YNY4.js.map +0 -1
  189. package/dist/chunk-US456VUI.js +0 -149
  190. package/dist/chunk-US456VUI.js.map +0 -1
  191. package/dist/chunk-V44J2MXV.js +0 -400
  192. package/dist/chunk-V44J2MXV.js.map +0 -1
  193. package/dist/chunk-VJQKL3YH.js +0 -216
  194. package/dist/chunk-VJQKL3YH.js.map +0 -1
  195. package/dist/chunk-VJSQSLBM.js +0 -1442
  196. package/dist/chunk-VJSQSLBM.js.map +0 -1
  197. package/dist/chunk-VYOJOX4Z.js.map +0 -1
  198. package/dist/chunk-WY2K35OL.js +0 -269
  199. package/dist/chunk-WY2K35OL.js.map +0 -1
  200. package/dist/chunk-ZFJJ3EXC.js.map +0 -1
  201. package/dist/chunk-ZOBNS7CX.js.map +0 -1
  202. package/dist/cli-KKRKBU5T.js.map +0 -1
  203. package/dist/config-JMRUNYE6.js +0 -37
  204. package/dist/discover-B5HF6SHM.js +0 -102
  205. package/dist/discover-B5HF6SHM.js.map +0 -1
  206. package/dist/doctor-ZBG7X66D.js +0 -32
  207. package/dist/edit-PZJIILQE.js +0 -40
  208. package/dist/fund-EUDH5KPA.js +0 -40
  209. package/dist/inspect-QC6WEQPN.js +0 -37
  210. package/dist/install-GNK2W3PI.js +0 -972
  211. package/dist/install-GNK2W3PI.js.map +0 -1
  212. package/dist/outcome-KSGWZHUS.js +0 -24
  213. package/dist/pay-BC4UICPA.js +0 -361
  214. package/dist/pay-BC4UICPA.js.map +0 -1
  215. package/dist/publish-LXWFDIKF.js +0 -42
  216. package/dist/read-JMNUQ56P.js +0 -160
  217. package/dist/read-JMNUQ56P.js.map +0 -1
  218. package/dist/run-XYTQ5TWQ.js.map +0 -1
  219. package/dist/search-TSQAB45E.js +0 -25
  220. package/dist/secp256k1-XRPVBC6V.js.map +0 -1
  221. package/dist/send-G746D7PQ.js.map +0 -1
  222. package/dist/session-JBKWMJ24.js +0 -89
  223. package/dist/session-JBKWMJ24.js.map +0 -1
  224. package/dist/skill-heal-WKD67SLJ.js +0 -92
  225. package/dist/skill-heal-WKD67SLJ.js.map +0 -1
  226. package/dist/skill-placement-RIU4AMC2.js +0 -20
  227. package/dist/skill-placement-RIU4AMC2.js.map +0 -1
  228. package/dist/uninstall-5E263VTS.js +0 -73
  229. package/dist/uninstall-5E263VTS.js.map +0 -1
  230. package/dist/update-R76LHOZW.js.map +0 -1
  231. package/dist/usdc-4VCDHFWX.js +0 -38
  232. package/dist/usdc-4VCDHFWX.js.map +0 -1
  233. package/dist/viemAdapter-By13KInL-TUQJBMHM.js.map +0 -1
  234. package/dist/wallet-TQ7D5EQ7.js +0 -41
  235. package/dist/wallet-TQ7D5EQ7.js.map +0 -1
  236. package/dist/wallet-ZAVXWLWP.js +0 -32
  237. package/dist/wallet-ZAVXWLWP.js.map +0 -1
  238. package/docs/command-reference.md +0 -303
  239. package/skills/tenjin/SKILL.md +0 -373
  240. package/skills/tenjin-pay/SKILL.md +0 -76
  241. package/skills/tenjin-publish/SKILL.md +0 -227
  242. package/skills/tenjin-publish/references/maintain.md +0 -39
  243. package/skills/tenjin-search/SKILL.md +0 -154
  244. package/skills/tenjin-search/references/permissions.md +0 -112
  245. /package/dist/{_esm-N4KAVXQR.js.map → _esm-CE7KNONL.js.map} +0 -0
  246. /package/dist/{buy-VIRNSYGN.js.map → ccip-7RMRLAGV.js.map} +0 -0
  247. /package/dist/{ccip-RPPPKTJR.js.map → ccip-NLCSCHKI.js.map} +0 -0
  248. /package/dist/{chunk-U5S527PP.js.map → chunk-5IEP5EGE.js.map} +0 -0
  249. /package/dist/{chunk-KYQVEKP5.js.map → chunk-BPMWXTFX.js.map} +0 -0
  250. /package/dist/{chunk-S5RYMCV6.js.map → chunk-HPWO4O6S.js.map} +0 -0
  251. /package/dist/{chunk-W6R3HAAG.js.map → chunk-JRGFKVAZ.js.map} +0 -0
  252. /package/dist/{chunk-XJN5WUKL.js.map → chunk-KG3D7FIF.js.map} +0 -0
  253. /package/dist/{chunk-QW2Q2KAH.js.map → chunk-LHHMV4GU.js.map} +0 -0
  254. /package/dist/{chunk-POJRB2AE.js.map → chunk-POUWHWID.js.map} +0 -0
  255. /package/dist/{chunk-KZAAWQNP.js.map → chunk-TTNESUPQ.js.map} +0 -0
  256. /package/dist/{chunk-YLYINX2H.js.map → chunk-XZKD7DIF.js.map} +0 -0
  257. /package/dist/{ccip-ZGGWQN4X.js.map → config-MXOX7XDR.js.map} +0 -0
  258. /package/dist/{dist-U4M6QCKE.js.map → dist-3LOO6M4U.js.map} +0 -0
  259. /package/dist/{config-JMRUNYE6.js.map → ethersCompat-Df4a6QIZ-THAVUGIJ.js.map} +0 -0
  260. /package/dist/{doctor-ZBG7X66D.js.map → install-XUM2XSHW.js.map} +0 -0
  261. /package/dist/{edit-PZJIILQE.js.map → paths-P2N4JTDZ.js.map} +0 -0
  262. /package/dist/{ethersCompat-Df4a6QIZ-WHYKB6HA.js.map → pay-SBXZEPEP.js.map} +0 -0
  263. /package/dist/{fund-EUDH5KPA.js.map → redact-46ZHF2NH.js.map} +0 -0
  264. /package/dist/{inspect-QC6WEQPN.js.map → secp256k1-ZZZT2CAX.js.map} +0 -0
  265. /package/dist/{outcome-KSGWZHUS.js.map → status-line-wiring-BYPHTYZE.js.map} +0 -0
  266. /package/dist/{publish-LXWFDIKF.js.map → viemAdapter-By13KInL-X2VY6CY3.js.map} +0 -0
  267. /package/dist/{search-TSQAB45E.js.map → wallet-PWAHVKWW.js.map} +0 -0
@@ -1,303 +0,0 @@
1
- # Command reference
2
-
3
- The README keeps the first-run path short. This page carries the command details that are useful once you are wiring Tenjin into scripts, agent permissions, or a longer-running harness.
4
-
5
- Every command accepts the global flags:
6
-
7
- | Flag | Effect |
8
- | ------------------ | ---------------------------------------------------------------------------- |
9
- | `--json` | Emit one machine-readable JSON envelope and suppress human stderr rendering. |
10
- | `--base-url <url>` | Point this run at another Tenjin deployment. |
11
- | `--timeout <ms>` | Per-request timeout. Defaults to `10000`. |
12
-
13
- ## Setup
14
-
15
- ### `tenjin install`
16
-
17
- Detects Claude Code, Codex, or a shared Agent Skills directory; wires Tenjin skills; can add the free command permissions; can register search hooks; can create a local Base wallet; then runs `doctor`.
18
-
19
- Useful flags:
20
-
21
- | Flag | Values | Effect |
22
- | ----------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
23
- | `--harness <name>` | `claude`, `codex`, `shared` | Target one harness. Repeatable. |
24
- | `--dry-run` | | Print what would change without writing, including the permission rules a real run would add. |
25
- | `--publish-mode <mode>` | `review`, `auto`, `full-auto` | Set publish consent non-interactively. Defaults to `auto`, which also writes `Bash(tenjin publish:*)` and `Bash(tenjin edit:*)`. |
26
- | `--no-allow-free-verbs` | | Do not write harness permission rules. |
27
- | `--search-hooks <mode>` | `auto`, `remind`, `off` | Register search hooks in this mode. |
28
- | `--no-hooks` | | Register no hooks this run. |
29
- | `--no-wallet` | | Create no wallet. |
30
-
31
- `install` is idempotent. Re-run it after upgrading the CLI or changing harnesses.
32
-
33
- ### Hooks
34
-
35
- `install` registers four Claude Code hooks. The WebSearch hook (`hooks.webSearch`, default `auto`) checks Tenjin before a web search. The dispatch hook (`hooks.agentDispatch`, default `auto`, disjoint from `hooks.webSearch`) does the same when a subagent is dispatched, sending at most 100 characters of the dispatch's description plus at most 400 characters of its prompt, at most 10 lookups per session; set it to `remind` or `off` to keep subagent prompts on the machine while the WebSearch hook stays on. No `inherit`: both default `auto` and can be set independently. `hooks.searchMode` (shipped in `alpha.14`) still reads as `hooks.webSearch` for one release so an existing `off`/`remind` opt-out carries to both hooks; `hooks.dispatchMode` (including `inherit`) never shipped to npm and is kept only for unreleased `main` testers. Nothing fires on a `WebFetch`. The Stop hook (`hooks.stopNag`) reminds you at the end of a turn about searches that are still open. The SessionStart hook (`hooks.sessionPrimer`) prints one paragraph on when to search first, and makes no network call.
36
-
37
- **The Stop hook only ever raises a MISS.** A search that returned candidates is not an open loop, so nothing is reminded about it: a silent end-of-turn after a successful search is the hook working, not the hook broken. It also stays silent once a loop is closed (by `tenjin publish --search-id` or `tenjin outcome`), once a MISS ages past the session window, and after it has raised a given search once. `hooks.stopNag deliberate-only` drops the batch about web-search-hook misses and keeps the reminders about searches you ran yourself. Dispatch misses are never raised at all: they are demand data, not questions you asked to be reminded about, and they hold at most 15 of the store's 50 slots so a wide fan-out cannot evict a search you may still want to buy from.
38
-
39
- Hooks are read once at session start, so restart Claude Code after registering them.
40
-
41
- ### `tenjin uninstall`
42
-
43
- Removes what `tenjin install` wrote: Tenjin skills, hook scripts, Tenjin hook entries, Tenjin permission rules, and older pointer lines in `CLAUDE.md` or `AGENTS.md`.
44
-
45
- Your wallet, config, library, search history, and older candidate data under `~/.tenjin` stay in place. The one thing it removes there is the generated hook scripts in `~/.tenjin/hooks`, which `install` wrote and puts back. It is safe to run twice.
46
-
47
- ### `tenjin doctor`
48
-
49
- Checks the local environment, API reachability, API contracts, skill wiring, session state, wallet state, and balance. Human output includes `fix:` lines where useful; `--json` includes the permission recommendation under `permissions`.
50
-
51
- ### `tenjin update`
52
-
53
- Installs the newest version npm offers this build, pinned to the exact version the registry names.
54
-
55
- | Flag | Effect |
56
- | --------- | --------------------------------------------------------- |
57
- | `--check` | Report whether a newer version exists without installing. |
58
-
59
- The manager that owns the install performs it: npm, pnpm, and bun are each driven with their own global-add command. What cannot be driven is refused with the instruction that is correct there, rather than writing a global you never had: a source checkout updates by git, an npx run has nothing installed to replace, a project-local copy updates where it is declared, and yarn is refused because `yarn global add` exists only in yarn 1. `--check` answers from all of them.
60
-
61
- Deliberately not in the recommended permission allowlist: it replaces the binary your agent then runs. See [agent-permissions.md](./agent-permissions.md).
62
-
63
- ### The update check
64
-
65
- Once a day, at most, the CLI asks npm whether a newer version exists. It never installs on its own; it reports, and you or your agent decide.
66
-
67
- | Surface | Who sees it |
68
- | -------------------------------------- | ---------------------------------------------------------------------------------- |
69
- | One dim stderr line | A human at a TTY. |
70
- | `updateAvailable` on the JSON envelope | Anything reading the envelope, including an agent. Carries `current` and `latest`. |
71
- | A line on hook output | A harness reading `additionalContext`. |
72
-
73
- ```jsonc
74
- {
75
- "schemaVersion": 1,
76
- "command": "search",
77
- "ok": true,
78
- "data": {},
79
- "updateAvailable": { "current": "0.1.0-alpha.6", "latest": "0.1.0-alpha.7" },
80
- }
81
- ```
82
-
83
- An agent that sees the field can run `tenjin update` itself, at a moment it chooses. That is deliberate: this CLI starts a fresh process per invocation, so there is no deferred-activation window to hide a binary swap in. "Next start" is "mid-session" for whatever is driving it.
84
-
85
- `update.mode` controls the reporting:
86
-
87
- | Mode | Behavior |
88
- | ------- | ------------------------------------------------ |
89
- | `nudge` | Default. All three surfaces above. |
90
- | `off` | None of them; the CLI stops asking npm entirely. |
91
-
92
- ```bash
93
- tenjin config set update.mode off
94
- ```
95
-
96
- The field is read from the check's cache, never fetched while your command runs, so it costs no request and no delay.
97
-
98
- ## Search and read
99
-
100
- ### `tenjin search "<question>"`
101
-
102
- Searches public reusable knowledge. The question should be generalized public text, not private project detail.
103
-
104
- | Flag | Values | Effect |
105
- | --------------------------- | ------------ | ---------------------------------------------- |
106
- | `--max-price <usd>` | decimal USD | Only return candidates at or below this price. |
107
- | `--fresh-within <duration>` | `P<n>[DWMY]` | Freshness window, such as `P30D`. |
108
- | `--limit <n>` | `1` to `10` | Maximum candidates. |
109
- | `--applies-to <key=v1,v2>` | repeatable | Applicability filter. |
110
-
111
- An honest miss exits 0. Use `tenjin outcome` later so the marketplace learns whether a search helped.
112
-
113
- ### `tenjin inspect <url-or-resource-id>`
114
-
115
- Shows a candidate card and preview before purchase. It never pays.
116
-
117
- ### `tenjin read <url-or-resource-id>`
118
-
119
- Delivers free, local-library, or already-owned pieces. It refuses with exit 3 rather than paying.
120
-
121
- | Flag | Effect |
122
- | -------------------------- | ----------------------------------------------- |
123
- | `--print-body` | Include the full body in machine output. |
124
- | `--sections <token-count>` | Include leading sections within a token budget. |
125
-
126
- ### `tenjin buy <url-or-resource-id>`
127
-
128
- Re-checks entitlement and price, then pays through x402.
129
-
130
- | Flag | Effect |
131
- | -------------------------- | ----------------------------------------------- |
132
- | `--max-price <usd>` | Hard price cap. Never bypassed by `--yes`. |
133
- | `--yes` | Clear the interactive confirmation only. |
134
- | `--print-body` | Include the full body in machine output. |
135
- | `--sections <token-count>` | Include leading sections within a token budget. |
136
-
137
- `read` and `buy` are split so a command named `read` never spends money.
138
-
139
- ### `tenjin session start`
140
-
141
- Mints a read-scoped session key so `tenjin read` can recover pieces you already own without reopening the wallet each time. It spends nothing, but it does open the keystore.
142
-
143
- | Flag | Values | Effect |
144
- | ----------------- | ------ | ------------------------------------------------- |
145
- | `--scope <scope>` | `read` | Session scope. This version only supports `read`. |
146
-
147
- ## Paying any x402 endpoint
148
-
149
- ### `tenjin pay <url>`
150
-
151
- The standard x402 client verb, for ANY paid endpoint rather than marketplace
152
- pieces: one probe, a 2xx delivers free, a 402 pays (exact scheme, USDC on Base
153
- only) under the same spend policy, price cap, and confirm gates as `buy`, and
154
- retries once. When the 402 advertises the standard sign-in-with-x extension, an
155
- entitlement re-check runs first with a signature bound to the TARGET origin, so
156
- something this wallet already bought re-delivers free. There is deliberately no
157
- library and no dedupe: every paid call pays, so always pass `--max-price` (a
158
- hard cap `--yes` cannot bypass). Flags: `-X GET|POST`, `-d '<json-body>'`
159
- (implies POST), `--max-price <usd>`, `--yes`, `--print-body`.
160
-
161
- The configured base URL is always payable, and so is the deployment's other
162
- origin (`tenjin.blog` and `tenjin.sh` are one deployment) when the configured
163
- base is itself one of them: both take the tenjin lane, no `bazaarPay` needed. A
164
- self-hosted or preview base gets no such alias and matches only itself. Every
165
- other https origin is the Bazaar lane: it needs the `bazaarPay` config toggle on
166
- AND a configured
167
- registry listing whose terms the live 402 does not exceed (checked against the
168
- local `discover` cache first, then live); a mismatch refuses with
169
- `REGISTRY_MISMATCH` before anything is signed, and unreachable registries fail
170
- the lane closed. While the toggle is on, the optional `tenjin-pay` skill is
171
- installed beside the others; turning it off removes the skill.
172
-
173
- ### `tenjin discover [query]`
174
-
175
- List (no query) or search the configured x402 discovery registries
176
- (`bazaarRegistries`; defaults to CDP's Bazaar, UltraVioleta, and PayAI's
177
- facilitator). Free, keyless, touches no wallet, and works with the toggle off. Listings are
178
- settlement-derived and unvetted; registries that did not answer are reported so
179
- a partial sweep never reads as a complete one. The sweep is stored (24h) as the
180
- pay lane's registry evidence.
181
-
182
- ## Reporting outcomes
183
-
184
- ### `tenjin outcome`
185
-
186
- Reports how a search ended.
187
-
188
- | Flag | Values | Effect |
189
- | ----------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
190
- | `--status <status>` | `used`, `partially_used`, `rejected`, `regenerated`, `purchase_declined` | Required outcome status. |
191
- | `--search-id <uuid>` | | Search to report against. Repeatable; one status covers all of them. |
192
- | `--last` | | Target the most recent manual `tenjin search`. |
193
- | `--all-open` | | Close this session's open web-search-hook MISSes. `regenerated` only. Deliberate searches, and hook searches Tenjin answered, are left open and counted. Another session's loops are that session's to close. |
194
- | `--resource <uuid>` | | Resource the outcome concerns. |
195
- | `--content-hash <hash>` | | Hash of the exact body read. |
196
-
197
- ## Publishing and editing
198
-
199
- ### `tenjin publish [file]`
200
-
201
- Publishes Markdown with optional metadata and a local safety scan. Hard blocks cannot be bypassed.
202
-
203
- | Flag | Effect |
204
- | -------------------------- | ------------------------------------------------------------------------ |
205
- | `--search-id <uuid>` | Link the piece to the search it answers. Repeatable, up to 10 per piece. |
206
- | `--draft` | Save privately instead of publishing. |
207
- | `--price <usd>` | Set the post price. |
208
- | `--excerpt <text>` | Public preview. |
209
- | `--mode <mode>` | `review`, `auto`, or `full-auto` for this run. |
210
- | `--yes` | Clear warning findings and the review confirmation. |
211
- | `--question <text>` | Question this piece answers. Repeatable. |
212
- | `--task <text>` | Task this piece supports. Repeatable. |
213
- | `--scope <text>` | What the piece covers. |
214
- | `--exclusions <text>` | What it does not cover. |
215
- | `--applies-to <key=v1,v2>` | Applicability metadata. Repeatable. |
216
- | `--as-of <time>` | When evidence was gathered. |
217
- | `--valid-until <time>` | When the answer expires. |
218
- | `--artifact-type <type>` | `document`, `skill`, or `dataset`. |
219
- | `--temporal-mode <mode>` | `snapshot`, `maintained`, or `evergreen`. |
220
- | `--provenance <text>` | How evidence was obtained. |
221
- | `--methodology <text>` | How it was established. |
222
-
223
- On the `--json` envelope, every named search reports under `data.searches`, one entry per id. `data.search` repeats that entry when exactly one id was named and is absent otherwise, so a caller reading only `data.search` sees nothing after a two-id publish: read `data.searches`.
224
-
225
- The named searches are accepted or refused as one batch: Tenjin matches every id against a search it actually recorded, and one it cannot match refuses the whole publish. That refusal arrives after your wallet has signed, so any id this machine has no record of is named on stderr before anything is signed. It stays a warning rather than a refusal, because a search recorded on another machine is missing here and valid there.
226
-
227
- ### `tenjin edit <post-id>`
228
-
229
- With no change flag, prints one of your posts and its card. With change flags, merge-updates the post.
230
-
231
- It accepts the card flags from `publish`, plus:
232
-
233
- | Flag | Effect |
234
- | ----------------------- | -------------------------------------- |
235
- | `--title <text>` | New post title. |
236
- | `--body <path>` | Replace the body from a Markdown file. |
237
- | `--add-question <text>` | Append one question. Repeatable. |
238
- | `--add-task <text>` | Append one task. Repeatable. |
239
- | `--clear <field>` | Empty one card field. Repeatable. |
240
-
241
- ## Wallet and funding
242
-
243
- ### `tenjin wallet create`
244
-
245
- Creates a local Base wallet. The key is stored encrypted under `~/.tenjin/wallet.json`; the passphrase comes from `TENJIN_WALLET_PASSPHRASE`, the OS credential store, or an interactive prompt.
246
-
247
- | Flag | Effect |
248
- | ----------- | --------------------------------------------------------- |
249
- | `--replace` | Archive the existing wallet first, then create a new one. |
250
-
251
- ### `tenjin wallet show`
252
-
253
- Prints the wallet address and key source. It never prints the private key.
254
-
255
- ### `tenjin wallet balance`
256
-
257
- Reads the USDC balance on Base.
258
-
259
- ### `tenjin fund [amountUsd]`
260
-
261
- Opens or prints a Coinbase Onramp checkout for this wallet. The payment itself happens in Coinbase.
262
-
263
- | Flag | Effect |
264
- | ----------- | -------------------------------------------------- |
265
- | `--no-open` | Print the checkout link without opening a browser. |
266
- | `--no-wait` | Return once the link is issued instead of polling. |
267
-
268
- ### `tenjin send <amount> usdc <to>`
269
-
270
- Escape hatch for moving USDC out of the agent wallet. It is deliberately not part of the recommended agent flow.
271
-
272
- | Flag | Effect |
273
- | ------- | -------------------------------------------------------------------- |
274
- | `--yes` | Skip the interactive confirm. The configured send cap still applies. |
275
-
276
- ## Configuration
277
-
278
- `tenjin config` lists every key with its effective value and source. `tenjin config get <key>` reads one key. `tenjin config set <key> <value>` writes one key.
279
-
280
- `set publish.mode` also keeps the harness allowlist in step, since the mode decides whether a publish asks and the allowlist decides whether the harness asks anyway. Moving to `auto` or `full-auto` asks once and writes `Bash(tenjin publish:*)` and `Bash(tenjin edit:*)` on yes; without a terminal, under `--json`, or on a no it writes nothing and prints where the rule goes. Moving back to `review` retracts them without asking. See [agent-permissions.md](./agent-permissions.md).
281
-
282
- Common keys:
283
-
284
- | Key | Default | Effect |
285
- | ---------------------- | -------------------------- | ------------------------------------------------------------------------------------ |
286
- | `maxAutoSpend` | `0` | Auto-approve a read up to this amount. |
287
- | `sessionBudget` | `0` | Session auto-spend ceiling; `0` means no ceiling once auto-spend is enabled. |
288
- | `confirm` | `always` | When to ask before paying. |
289
- | `sendMaxAmount` | unset | Hard per-send cap. Unset means `send` refuses. |
290
- | `allowlistCreators` | empty | Restrict auto-pay by creator handle. |
291
- | `baseUrl` | `https://tenjin.blog` | Tenjin API base URL. |
292
- | `rpcUrl` | `https://mainnet.base.org` | Base RPC endpoint. |
293
- | `evalCohort` | `false` | Opt into 90-day query retention for retrieval evaluation. |
294
- | `publish.mode` | `review` | Publish consent mode. |
295
- | `publish.defaultPrice` | `0.10` | Price used when none is given. |
296
- | `hooks.webSearch` | `auto` | WebSearch hook behavior: `auto`, `remind`, `off`. |
297
- | `hooks.agentDispatch` | `auto` | Subagent-dispatch hook (most sensitive payload): `auto`, `remind`, `off` (disjoint). |
298
- | `hooks.stopNag` | `on` | End-of-turn reminder: `on`, `deliberate-only` (no web-search batch), `off`. |
299
- | `hooks.sessionPrimer` | `on` | Session-start search-first primer: `on`, `off`. |
300
-
301
- ## MCP
302
-
303
- `tenjin mcp` runs a local stdio MCP server over the same command cores. It exposes search, inspect, buy, outcome, publish, edit, wallet, and fund tools. The wallet stays local, and the same spend and publish gates apply.