@evident-ai/cli 3.3.1-dev.e98fa27 → 3.4.1-dev.0b03f1c

package/README.md

@@ -98,13 +98,55 @@ 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).
+- `--opencode-version <v1|v2>` — Which OpenCode major version to launch: `v1` or
+  `v2` (default: `v1`). Env: `EVIDENT_OPENCODE_VERSION`. **`v2` currently only works
+  against an already-running, unauthenticated `opencode2` process** — auto-starting
+  one is hard-gated off pending
+  [#2075](https://github.com/sroze/evident/issues/2075) and errors immediately
+  otherwise.
+- `--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`.
+- `--credential-sync-marker <path>` — Own the interval credential sync and write
+  this marker once the shutdown flush has finished, so the runner image's lifecycle
+  hooks can wait on it.
 - `--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
+  by default; nothing else about the machine leaves it. Env:
+  `EVIDENT_RESOURCE_USAGE_REPORTING=off` (the flag wins if both are set).
 - `--json` — Output in JSON format (forces non-interactive mode).
 - `--session-cleanup-max-age <duration>` — Delete OpenCode sessions idle longer
   than this window (format `<number><unit>`, unit one of `s, m, h, d` — e.g.
@@ -171,10 +213,20 @@ 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.
+- `OPENCODE_LOG_LEVEL` — OpenCode log level when `evident run` starts an
+  image-owned process: `DEBUG`, `INFO`, `WARN`, or `ERROR` (default: `INFO`).
+  Invalid values fall back to `INFO`.
 - `EVIDENT_LOG_LEVEL` — Equivalent to `--log-level`; the flag wins if both are
   set, and `-v`/`--verbose` also outranks this env var.
 - `EVIDENT_OPENCODE_START_TIMEOUT` — Equivalent to `--opencode-start-timeout`
   (seconds); the flag wins if both are set.
+- `EVIDENT_OPENCODE_VERSION` — Equivalent to `--opencode-version`; the flag wins
+  if both are set. Defaults to `v1`.
 - `EVIDENT_SESSION_CLEANUP_MAX_AGE` — Equivalent to `--session-cleanup-max-age`;
   the flag wins if both are set.
 - `EVIDENT_SESSION_CLEANUP_MAX_COUNT` — Equivalent to
@@ -183,6 +235,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` →