docs(curator): update CLI docs for synchronous-by-default manual run

Follow-up to the previous commit which flipped 'hermes curator run'
default from async to sync. Updates the curator.md feature page and
cli-commands.md reference to show --background as the opt-in async
flag and note that the default now blocks until the LLM pass finishes.
This commit is contained in:
Teknium 2026-05-07 05:25:44 -07:00
parent 6b9f7140bb
commit 6b3a9b4bfa
2 changed files with 4 additions and 4 deletions

View file

@ -802,8 +802,8 @@ The curator is an auxiliary-model background task that periodically reviews agen
| Subcommand | Description | | Subcommand | Description |
|------------|-------------| |------------|-------------|
| `status` | Show curator status and skill stats | | `status` | Show curator status and skill stats |
| `run` | Trigger a curator review now | | `run` | Trigger a curator review now (blocks until the LLM pass finishes) |
| `run --sync` | Block until the LLM pass finishes | | `run --background` | Start the LLM pass in a background thread and return immediately |
| `run --dry-run` | Preview only — produce the review report with no mutations | | `run --dry-run` | Preview only — produce the review report with no mutations |
| `backup` | Take a manual tar.gz snapshot of `~/.hermes/skills/` (curator also snapshots automatically before every real run) | | `backup` | Take a manual tar.gz snapshot of `~/.hermes/skills/` (curator also snapshots automatically before every real run) |
| `rollback` | Restore `~/.hermes/skills/` from a snapshot (defaults to newest) | | `rollback` | Restore `~/.hermes/skills/` from a snapshot (defaults to newest) |

View file

@ -84,8 +84,8 @@ Earlier releases used a one-off `curator.auxiliary.{provider,model}` block. That
```bash ```bash
hermes curator status # last run, counts, pinned list, LRU top 5 hermes curator status # last run, counts, pinned list, LRU top 5
hermes curator run # trigger a review now (background by default) hermes curator run # trigger a review now (blocks until the LLM pass finishes)
hermes curator run --sync # same, but block until the LLM pass finishes hermes curator run --background # fire-and-forget: start the LLM pass in a background thread
hermes curator run --dry-run # preview only — report without any mutations hermes curator run --dry-run # preview only — report without any mutations
hermes curator backup # take a manual snapshot of ~/.hermes/skills/ hermes curator backup # take a manual snapshot of ~/.hermes/skills/
hermes curator rollback # restore from the newest snapshot hermes curator rollback # restore from the newest snapshot