@evident-ai/cli 3.1.1-dev.2b250ad → 3.1.1-dev.2b780b5

package/README.md

@@ -94,7 +94,53 @@ Options:
 - `-c, --conversation <id>` — Process only this specific conversation.
 - `--idle-timeout <seconds>` — Exit after N seconds with no pending work (useful
   in CI to avoid polling indefinitely).
+- `--opencode-start-timeout <seconds>` — How long to wait for OpenCode to become
+  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).
+- `--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`.
 - `--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.
+  `7d`, `24h`). Setting this (or `--session-cleanup-max-count`) is what enables
+  cleanup — there is no separate on/off flag. An invalid value is warned about
+  and ignored, which can leave cleanup off if it was the only rule set. Env:
+  `EVIDENT_SESSION_CLEANUP_MAX_AGE`.
+- `--session-cleanup-max-count <n>` — Keep only the newest N OpenCode sessions
+  by last activity, deleting the rest. Also enables cleanup; combines with
+  `--session-cleanup-max-age` as OR. A session with a turn actively in progress
+  is never deleted, regardless of either rule. Env:
+  `EVIDENT_SESSION_CLEANUP_MAX_COUNT`.
+- `--max-active-sessions <n>` — Cap how many sessions the runner will have
+  actively working at once (default: unlimited). Counts sessions with work in
+  flight and is per runner process, not global across runners. Once the cap is
+  reached, new work simply stays pending and is picked up on a later poll tick
+  — nothing is dropped or errored — but a follow-up into a conversation whose
+  session is already active is never blocked, since it costs no extra slot. A
+  legitimately long-running turn holds its slot for as long as it runs
+  (bounded only by the 6h absolute processing ceiling), so pick N with that in
+  mind. After a restart the runner re-adopts work it had already claimed,
+  which can briefly push the active count above the cap — that's deliberate;
+  the cap bounds new dispatch, not re-adoption. An invalid value (`0`,
+  negative, non-numeric) is warned about and falls back to unlimited. Env:
+  `EVIDENT_MAX_ACTIVE_SESSIONS`.
+- `--session-cleanup-interval <duration>` — How often the cleanup sweep runs
+  (default: `1h`). An invalid value falls back to the default rather than
+  disabling cleanup. Env: `EVIDENT_SESSION_CLEANUP_INTERVAL`.
+- `--enable-file-sync-to <dir>` — Let the runner write files Evident has queued
+  for it into this directory — it collects them as part of the polling it
+  already does, so they land a couple of seconds after you hand them over.
+  Repeatable (up to 16); each value must be absolute once a leading `~` is
+  expanded, and the filesystem root is rejected. Omit it entirely and the
+  runner collects nothing and refuses any queued file, telling you why. Use
+  `--enable-file-sync-to ~/.claude` to connect a Claude subscription from the
+  web — see the website's Model providers doc.
 
 ## Global flags
 
@@ -118,6 +164,20 @@ targets the **production** Evident platform by default.
   keychain login from `evident login`).
 - `EVIDENT_API_URL` — Override the API base URL (equivalent to `--endpoint`).
 - `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_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_SESSION_CLEANUP_MAX_AGE` — Equivalent to `--session-cleanup-max-age`;
+  the flag wins if both are set.
+- `EVIDENT_SESSION_CLEANUP_MAX_COUNT` — Equivalent to
+  `--session-cleanup-max-count`; the flag wins if both are set.
+- `EVIDENT_MAX_ACTIVE_SESSIONS` — Equivalent to `--max-active-sessions`; the
+  flag wins if both are set.
+- `EVIDENT_SESSION_CLEANUP_INTERVAL` — Equivalent to
+  `--session-cleanup-interval`; the flag wins if both are set.
 
 Authentication precedence for `run`: `EVIDENT_RUNNER_KEY`/`EVIDENT_AGENT_KEY`
 (tied; `EVIDENT_RUNNER_KEY` wins if both are set) → `EVIDENT_TOKEN` →