mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-11-06 05:17:15 +00:00
docs(update): CLI reference names stable as the default and --set-channel main as the way back
The reference still said hermes update pulls main by default and that main is the only valid source channel, contradicting the updating guide.
This commit is contained in:
1 parent
158cd52a6b
commit
07908be267
2 files changed
+6
-6
No files matched your search
@@ -109,7 +109,7 @@ The install also ships `hermes-agent`, a minimal runner that sends one query and
|
||||
| `hermes profile` | Manage profiles — multiple isolated Hermes instances. |
|
||||
| `hermes completion` | Print shell completion scripts (bash/zsh/fish). |
|
||||
| `hermes --version` | Show version information. |
|
||||
| `hermes update` | Pull latest code and reinstall dependencies. `--check` previews without installing; `--backup` takes a pre-pull `HERMES_HOME` snapshot. |
|
||||
| `hermes update` | Update to the latest stable release (or the selected channel) and reinstall dependencies. `--check` previews without installing; `--backup` takes a pre-pull `HERMES_HOME` snapshot. |
|
||||
| `hermes uninstall` | Remove Hermes from the system. |
|
||||
|
||||
## `hermes chat`
|
||||
@@ -1998,13 +1998,13 @@ Use `--check` to compare with its configured source target without applying
|
||||
the update. Desktop bundles, Docker, Nix, and Termux packages retain their
|
||||
external update owner. See [Updating & Uninstalling](../getting-started/updating.md).
|
||||
|
||||
`hermes update` pulls the configured update branch (default: `main`). If your checkout is on another branch, Hermes may check out the update branch before pulling. Commit branch work before updating when you want to keep it outside the update autostash flow.
|
||||
`hermes update` follows this installation's update channel. A source checkout of the official repository defaults to `stable`, the latest published `vX.Y.Z` GitHub release at its exact commit; forks and mirrors default to `main`. To follow every commit on `main` instead, run `hermes update --set-channel main`; `hermes update --set-channel stable` switches back. On the `main` channel, a checkout on another branch may be switched to the update branch before pulling. Commit branch work before updating when you want to keep it outside the update autostash flow.
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| `--install-id` | Print this installation's identity and path, then exit. |
|
||||
| `--set-channel CHANNEL` | Persist the update channel for this source installation without applying an update. `main` is the only valid source channel. Bundled applications have a fixed build channel and refuse channel changes. |
|
||||
| `--channel CHANNEL` | Select a source channel for this invocation only (`main` is the only valid one). |
|
||||
| `--set-channel CHANNEL` | Persist the update channel for this source installation without applying an update: `stable` (published releases) or `main` (every commit). Bundled applications have a fixed build channel and refuse channel changes. |
|
||||
| `--channel CHANNEL` | Select a source channel for this invocation only (`stable` or `main`); nothing is saved. |
|
||||
| `--branch NAME` | Select a source branch for this invocation; takes precedence over source channel selection. |
|
||||
| `--gateway` | Internal mode used by the messaging `/update` command. Uses file-based IPC for prompts and progress streaming instead of reading from terminal stdin. Not a gateway restart flag. |
|
||||
| `--check` | Check whether an update is available without pulling, installing dependencies, or restarting anything. |
|
||||
|
||||
+2
-2
@@ -1237,11 +1237,11 @@ PM 管理工具和 Python 依赖,不负责替换应用发布包。
|
||||
hermes update [--check] [--backup] [--restart-gateway]
|
||||
```
|
||||
|
||||
拉取最新的 `hermes-agent` 代码并在受管理的 venv 中重新安装依赖,然后重新运行安装后 hook(MCP 服务器、skill 同步、补全安装)。可在运行中的安装上安全执行。使用 `--check` 查看你的检出是否落后于 `origin/main`,而不安装。
|
||||
拉取最新的 `hermes-agent` 代码并在受管理的 venv 中重新安装依赖,然后重新运行安装后 hook(MCP 服务器、skill 同步、补全安装)。可在运行中的安装上安全执行。官方仓库的源码检出默认跟踪 `stable` 渠道(最新正式发布的 `vX.Y.Z` 版本);运行 `hermes update --set-channel main` 改为跟踪 `main` 上的每个提交,`hermes update --set-channel stable` 切换回来。使用 `--check` 查看你的检出是否落后于所选渠道,而不安装。
|
||||
|
||||
| 选项 | 说明 |
|
||||
|--------|-------------|
|
||||
| `--check` | 并排打印当前 commit 和最新 `origin/main` commit,同步时退出码为 0,落后时为 1。不拉取、不安装、不重启任何内容。 |
|
||||
| `--check` | 并排打印当前 commit 和所选渠道的目标 commit,同步时退出码为 0,落后时为 1。不拉取、不安装、不重启任何内容。 |
|
||||
| `--backup` | 在拉取前创建 `HERMES_HOME` 的带标签预更新快照(config、auth、会话、skill、配对数据)。默认**关闭**——之前的始终备份行为在大型主目录上每次更新会增加数分钟。通过 `config.yaml` 中的 `update.backup: true` 永久开启。 |
|
||||
| `--restart-gateway` | 成功更新后重启正在运行的 gateway 服务。如果安装了多个 profile,隐含 `--all` 语义。 |
|
||||
|
||||
|
||||
Reference in new issue
Block a user