{"_id":"@buckeyestudio/toh","name":"@buckeyestudio/toh","dist-tags":{"next":"0.1.1-rc.2","latest":"0.1.1-rc.2"},"versions":{"0.1.1-rc.2":{"name":"@buckeyestudio/toh","description":"toh CLI: profile boot, plugin management, and the browser UI alias","version":"0.1.1-rc.2","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/dustinwloring1988/theopen-harness.git","directory":"apps/cli"},"type":"module","bin":{"toh":"lib/bin.js"},"license":"MIT","author":{"name":"buckeyestudio"},"dependencies":{"commander":"^15.0.0","js-yaml":"^4.2.0","node-addon-require-builtin":"^0.1.4","@buckeyestudio/cordis-plugin-hmr":"^1.0.16","@buckeyestudio/cordis-plugin-include":"^1.0.6","@buckeyestudio/cordis-plugin-timer":"^1.1.3","@buckeyestudio/toh-agent-tool-presentation":"^0.1.1-rc.2","@buckeyestudio/cordis-plugin-loader":"^1.0.2","@buckeyestudio/toh-app-boot":"^0.1.1-rc.2","@buckeyestudio/toh-base":"^0.1.1-rc.2","@buckeyestudio/toh-cordis-client-runner":"^0.1.1-rc.2","@buckeyestudio/toh-client-ui-agent-preset":"^0.1.1-rc.2","@buckeyestudio/toh-client-ui-cordis":"^0.1.1-rc.2","@buckeyestudio/toh-command-compact":"^0.1.1-rc.2","@buckeyestudio/toh-compaction-basic":"^0.1.1-rc.2","@buckeyestudio/toh-goal":"^0.1.1-rc.2","@buckeyestudio/toh-compaction-tool-result-pruner":"^0.1.1-rc.2","@buckeyestudio/toh-goal-round-driver":"^0.1.1-rc.2","@buckeyestudio/toh-command-goal":"^0.1.1-rc.2","@buckeyestudio/toh-cmdline":"^0.1.1-rc.2","@buckeyestudio/toh-launch-environment":"^0.1.1-rc.2","@buckeyestudio/toh-mcp-client":"^0.1.1-rc.2","@buckeyestudio/toh-headless":"^0.1.1-rc.2","@buckeyestudio/toh-persona":"^0.1.1-rc.2","@buckeyestudio/toh-home-paths":"^0.1.1-rc.2","@buckeyestudio/toh-plan-mode":"^0.1.1-rc.2","@buckeyestudio/toh-fs-local":"^0.1.1-rc.2","@buckeyestudio/toh-terminal":"^0.1.1-rc.2","@buckeyestudio/toh-terminal-bash":"^0.1.1-rc.2","@buckeyestudio/toh-pwsh-local":"^0.1.1-rc.2","@buckeyestudio/toh-pwsh-sandbox":"^0.1.1-rc.2","@buckeyestudio/toh-time-context":"^0.1.1-rc.2","@buckeyestudio/toh-skill":"^0.1.1-rc.2","@buckeyestudio/toh-session-projection":"^0.1.1-rc.2","@buckeyestudio/toh-session-reference":"^0.1.1-rc.2","@buckeyestudio/toh-skill-filesystem":"^0.1.1-rc.2","@buckeyestudio/toh-token-meter":"^0.1.1-rc.2","@buckeyestudio/toh-tool-bash":"^0.1.1-rc.2","@buckeyestudio/toh-jobs-local":"^0.1.1-rc.2","@buckeyestudio/toh-tool-ask-user":"^0.1.1-rc.2","@buckeyestudio/toh-tool-bash-persistent":"^0.1.1-rc.2","@buckeyestudio/toh-tool-cordis":"^0.1.1-rc.2","@buckeyestudio/toh-tool-pwsh-persistent":"^0.1.1-rc.2","@buckeyestudio/toh-tool-fs":"^0.1.1-rc.2","@buckeyestudio/toh-tmux-context":"^0.1.1-rc.2","@buckeyestudio/toh-tool-fs-search":"^0.1.1-rc.2","@buckeyestudio/toh-tool-ralph":"^0.1.1-rc.2","@buckeyestudio/toh-schedule":"^0.1.1-rc.2","@buckeyestudio/toh-tool-goal":"^0.1.1-rc.2","@buckeyestudio/toh-tool-str-replace-editor":"^0.1.1-rc.2","@buckeyestudio/toh-tool-pwsh":"^0.1.1-rc.2","@buckeyestudio/toh-tool-subagent":"^0.1.1-rc.2","@buckeyestudio/toh-tool-subagent-control":"^0.1.1-rc.2","@buckeyestudio/toh-tool-todo":"^0.1.1-rc.2","@buckeyestudio/toh-tool-jobs":"^0.1.1-rc.2","@buckeyestudio/toh-tool-web":"^0.1.1-rc.2","@buckeyestudio/toh-tool-skill":"^0.1.1-rc.2","@buckeyestudio/toh-tool-workflow":"^0.1.1-rc.2","@buckeyestudio/toh-web-app":"^0.1.1-rc.2","@buckeyestudio/toh-workflow-worker-thread":"^0.1.1-rc.2","@buckeyestudio/cordis":"^4.0.1","@buckeyestudio/toh-agent-instructions":"^0.1.1-rc.2"},"devDependencies":{"@types/js-yaml":"^4.0.9","execa":"^10.0.0","@buckeyestudio/toh-agent":"^0.1.1-rc.2","@buckeyestudio/toh-host-frontend-static":"^0.1.1-rc.2","@buckeyestudio/toh-host-apiproxy":"^0.1.1-rc.2","@buckeyestudio/toh-host-webserver":"^0.1.1-rc.2","@buckeyestudio/toh-llm":"^0.1.1-rc.2","@buckeyestudio/toh-llm-mock-server":"^0.1.1-rc.2","@buckeyestudio/toh-loader-smoke":"^0.1.1-rc.2","@buckeyestudio/toh-session":"^0.1.1-rc.2","@buckeyestudio/toh-settings":"^0.1.1-rc.2","@buckeyestudio/toh-subagent":"^0.1.1-rc.2","@buckeyestudio/toh-system-prompt":"^0.1.1-rc.2","@buckeyestudio/toh-tools":"^0.1.1-rc.2"},"_id":"@buckeyestudio/toh@0.1.1-rc.2","bugs":{"url":"https://github.com/dustinwloring1988/theopen-harness/issues"},"homepage":"https://github.com/dustinwloring1988/theopen-harness#readme","_integrity":"sha512-CNO1uCaLPxYJwgos5Ssw5+ZANE9DV7nuebjzNp+cZmPDKbyGJmX5d0++B760rM4GysaWcpEGQOVOMirme3aVNw==","_resolved":"/home/runner/work/theopen-harness/theopen-harness/dist/npm/buckeyestudio-toh-0.1.1-rc.2.tgz","_from":"file:/home/runner/work/theopen-harness/theopen-harness/dist/npm/buckeyestudio-toh-0.1.1-rc.2.tgz","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-CNO1uCaLPxYJwgos5Ssw5+ZANE9DV7nuebjzNp+cZmPDKbyGJmX5d0++B760rM4GysaWcpEGQOVOMirme3aVNw==","shasum":"a27a1d1ebe0e01f6781c9ffe56c52da95c2371d7","tarball":"https://registry.npmjs.org/@buckeyestudio/toh/-/toh-0.1.1-rc.2.tgz","fileCount":21,"unpackedSize":122931,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC7bpOMqsN5VTrdDEtOzZrs0xzU3KvrofxWzANsjnJA4gIhAIlvfq9Bzxd2kT2kSIyiIstz+5mWxCLrMqNYSXhzI3Is"}]},"_npmUser":{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"},"directories":{},"maintainers":[{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/toh_0.1.1-rc.2_1787489724425_0.9029937659477048"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T12:55:24.279Z","0.1.1-rc.2":"2026-08-23T12:55:24.578Z","modified":"2026-08-23T12:55:24.885Z"},"maintainers":[{"name":"buckeyestudio","email":"dustinwloring1988@gmail.com"}],"description":"toh CLI: profile boot, plugin management, and the browser UI alias","homepage":"https://github.com/dustinwloring1988/theopen-harness#readme","repository":{"type":"git","url":"git+https://github.com/dustinwloring1988/theopen-harness.git","directory":"apps/cli"},"author":{"name":"buckeyestudio"},"bugs":{"url":"https://github.com/dustinwloring1988/theopen-harness/issues"},"license":"MIT","readme":"# `@buckeyestudio/toh`\n\n[English](README.md) | 中文\n\n`toh` 是 TheOpen Harness 中用于启动 profile 的命令；profile 由多个插件组合包 patch 层按顺序叠加而成，其上再应用用户自己的覆盖配置。[`src/args.ts`](src/args.ts) 负责命令语法，[`src/bin.ts`](src/bin.ts) 只加载选中的运行器。无效命令、来自其他模式的选项、配置错误和启动失败都会以非零状态退出。\n\n## 入口模式\n\n| 命令 | 用途 |\n|---|---|\n| `toh --profile <name>` | 启动位于 `$TOH_HOME/profiles/<name>` 的指定 profile。 |\n| `toh --profile headless \"job\"` | 运行一个全新的持久化会话，打印最终答案并退出。 |\n| `toh web` | `--profile web` 的别名。 |\n| `toh plugin --profile <name> <pnpm args>` | 通过在 profile 目录中转发给 pnpm 来管理该 profile 的插件。 |\n\n运行命令时所在的目录将作为默认 workspace 根目录。`web` 和 `headless` profile 在首次使用时会从随附模板自动初始化；其他任何 profile 都必须通过 `toh plugin` 创建。\n\n## 应用参数\n\n启动器只解析自身的 flag，并将其后的所有内容交给已启动的 profile；注入该 profile 的任意应用插件都可以解析这份共享的不可变快照（[`toh-cmdline`](../../packages/boot/cmdline/README.zh.md)）。因此，启动器的 flag 必须写在最前面；启动器无法识别的第一个 token 标志着应用参数的开始：\n\n```sh\ntoh --profile web --port 8080       # --port belongs to the web app\ntoh --profile tui --resume <id>     # example, assuming the tui profile is installed; --resume belongs to the terminal app\ntoh --profile headless \"run the tests\"\ntoh --profile web --help            # the web app's flags, not the launcher's\ntoh --help                          # the launcher's own help\n```\n\n<a id=\"profiles\"></a>\n\n## Profile\n\nprofile 目录包含一个 `package.json`，其中记录树外插件依赖，以及 profile manifest（元数据清单）`toh.profile` 和其中按顺序排列的 `bundles` 列表；还包含一个 `cordis.patch.yml`，其中保存用户自己的 patch 层。\n\n配置树以空根为起点，依次叠加以下配置层：\n- `toh.profile.bundles` 中各组合包的 patch\n- profile 自身的 `cordis.patch.yml`，然后是 home 级的 `$TOH_HOME/cordis.patch.yml`\n- `--patch` 指定的覆盖层\n\n`toh.profile.bundles` 中列出的组合包先从 toh 安装目录解析（`@buckeyestudio/toh-base`、`@buckeyestudio/toh-web-app`、`@buckeyestudio/toh-headless`），再从 profile 自身的 `node_modules` 解析；pnpm 会将树外插件安装到该目录。\n\n使用 `--dump-default-config` 和 `--dump-config` 可在不启动的情况下检查组合后的配置树。\n\n层的确切优先级、flag、关闭行为、部署默认值和源码执行方式，以 [CLI（命令行界面）行为参考](reference/README.zh.md)为准。\n\n## 开发\n\n生产运行需要已构建的包与前端产物。请在仓库根目录单独运行 `pnpm run build`，然后使用 `pnpm toh <args...>` 运行 TypeScript 入口并转发所有参数；模块解析约定以[源码执行参考](reference/README.zh.md#source-execution)为准。\n","readmeFilename":"README.zh.md","_rev":"1-dbcf48fe51e22491b6654f1b32888994"}