@evident-ai/cli 3.4.1-dev.8fa4d29 → 3.4.1-dev.9c22b93

package/README.md

@@ -98,13 +98,41 @@ Options:
   healthy when the runner starts it itself (default: `180`). On expiry the runner
   warns and comes online anyway rather than failing. Env:
   `EVIDENT_OPENCODE_START_TIMEOUT` (seconds).
+- `--litestream-config <path>` — Start `litestream replicate` for the OpenCode
+  session database with this config file. Use this for runner images that persist
+  the session database; the file is produced by `runner-synchroniser litestream-config`.
+  Omit it to disable replication.
+- `--opencode-pid-file <path>` — Record the image-owned OpenCode process ID here and
+  leave that process running at shutdown for the runner image's lifecycle hooks to stop.
+- `--litestream-pid-file <path>` — Record the image-owned Litestream process ID here and
+  leave that process running at shutdown for the runner image's lifecycle hooks to stop.
+- `--session-db-no-replicate-marker <path>` — Read this marker before starting
+   Litestream; session-DB restore writes it when this boot's database is not safe to
+   replicate.
+- `--restore-session-db` — Restore and verify the OpenCode session database before
+  starting OpenCode. Requires `--litestream-config` for the replica location and
+  `--session-db-no-replicate-marker` for give-up records. Omit it for a normal local
+  run.
+- `--restore-runner-credentials` — Restore the hosted runner secret and persisted
+   credential stores before starting OpenCode. Intended for runner images; omit it
+   for a normal local run.
+- `--opencode-config-overlay <path>` — Apply a runner-provided OpenCode config
+  before starting OpenCode. Relative paths are resolved from the working directory;
+  an existing `opencode.jsonc` is replaced before `opencode.json`.
 - `--claude-usage-reporting <mode>` — Whether to report the local Claude Code
   subscription's rate-limit usage to Evident, so it shows on the runner page:
   `auto` (default) reports it when a usable Claude Code login is found on this
   machine and stays silent otherwise; `on` forces reporting and warns loudly (and
   keeps retrying) if no usable login is found; `off` disables it entirely — no
   Claude credential is ever read. An unrecognized value falls back to `auto` with
-  a warning. Env: `EVIDENT_CLAUDE_USAGE_REPORTING`.
+   a warning. Env: `EVIDENT_CLAUDE_USAGE_REPORTING`.
+- `--openai-usage-reporting <mode>` — Whether to report the ChatGPT plan usage
+  from an OpenCode login to Evident, so it shows on the runner page: `auto`
+  (default) reports it when a usable ChatGPT login is found and stays silent
+  otherwise; `on` forces reporting and warns loudly (and keeps retrying) if no
+  usable login is found; `off` disables it entirely — no OpenCode login is ever
+  read. An unrecognized value falls back to `auto` with a warning. Env:
+  `EVIDENT_OPENAI_USAGE_REPORTING`.
 - `--no-resource-usage-reporting` — Don't report this machine's CPU
   utilization, total and available memory, core count, disk space, and the
   OpenCode session-store size to Evident, so it shows on the runner page. On
@@ -176,6 +204,8 @@ targets the **production** Evident platform by default.
 - `EVIDENT_TUNNEL_URL` — Override the tunnel relay URL (equivalent to `--tunnel`).
 - `EVIDENT_CLAUDE_USAGE_REPORTING` — Equivalent to `--claude-usage-reporting`; the
   flag wins if both are set.
+- `EVIDENT_OPENAI_USAGE_REPORTING` — Equivalent to `--openai-usage-reporting`; the
+  flag wins if both are set.
 - `EVIDENT_RESOURCE_USAGE_REPORTING` — Equivalent to
   `--no-resource-usage-reporting`; set it to `off` to disable. The flag wins
   if both are set.
@@ -191,6 +221,9 @@ targets the **production** Evident platform by default.
   flag wins if both are set.
 - `EVIDENT_SESSION_CLEANUP_INTERVAL` — Equivalent to
   `--session-cleanup-interval`; the flag wins if both are set.
+- `EVIDENT_SESSION_DB_PROVENANCE_STATE` — Override the path where the CLI stores
+  session-database provenance state (default:
+  `~/.local/state/evident/session-db-provenance.json`).
 
 Authentication precedence for `run`: `EVIDENT_RUNNER_KEY`/`EVIDENT_AGENT_KEY`
 (tied; `EVIDENT_RUNNER_KEY` wins if both are set) → `EVIDENT_TOKEN` →