@evident-ai/cli 3.0.1-dev.fbf2c4d → 3.0.1-dev.fbf37f6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +17 -15
  2. package/dist/index.js +361 -98
  3. package/dist/index.js.map +1 -1
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -5,7 +5,7 @@ Run OpenCode locally and connect it to the [Evident](https://evident.run) platfo
5
5
  The `evident` CLI starts (or attaches to) `opencode serve` on your machine and
6
6
  exposes it to Evident over a secure tunnel. Your code, secrets, and tools stay
7
7
  local — only the messages you send travel through Evident. Once connected, you
8
- can reach your agent from the web and from Slack.
8
+ can reach your runner from the web and from Slack.
9
9
 
10
10
  ## Installation
11
11
 
@@ -65,13 +65,13 @@ evident whoami
65
65
 
66
66
  ### `evident run`
67
67
 
68
- Connect to Evident and serve your agent. `evident run` authenticates, resolves
69
- which agent to run, ensures `opencode serve` is running on loopback, opens the
70
- streaming tunnel (which transparently proxies the agent's web surface), and
68
+ Connect to Evident and serve your runner. `evident run` authenticates, resolves
69
+ which runner to run, ensures `opencode serve` is running on loopback, opens the
70
+ streaming tunnel (which transparently proxies the runner's web surface), and
71
71
  delivers any channel messages (e.g. Slack) to your local OpenCode.
72
72
 
73
73
  ```bash
74
- # Interactive: connect a specific agent
74
+ # Interactive: connect a specific runner
75
75
  evident run --agent <agent-id>
76
76
 
77
77
  # Drive a single conversation
@@ -83,10 +83,12 @@ evident run --agent <agent-id> --idle-timeout 30
83
83
 
84
84
  Options:
85
85
 
86
- - `-a, --agent [id]` — Agent ID to connect to. Optional when `EVIDENT_AGENT_KEY`
87
- is set (the agent is then resolved automatically from the key).
86
+ - `-a, --agent [id]` — Runner ID to connect to. Optional when `EVIDENT_AGENT_KEY`
87
+ is set (the runner is then resolved automatically from the key).
88
88
  - `-p, --port <port>` — OpenCode port (default: `4096`).
89
- - `-v, --verbose` — Show detailed request/response information.
89
+ - `--log-level <level>` — Log verbosity: `debug | info | warn | error` (default:
90
+ `info`). Env: `EVIDENT_LOG_LEVEL`.
91
+ - `-v, --verbose` — Alias for `--log-level debug` (an explicit `--log-level` wins).
90
92
  - `-c, --conversation <id>` — Process only this specific conversation.
91
93
  - `--idle-timeout <seconds>` — Exit after N seconds with no pending work (useful
92
94
  in CI to avoid polling indefinitely).
@@ -103,8 +105,8 @@ targets the **production** Evident platform by default.
103
105
 
104
106
  ## Environment variables
105
107
 
106
- - `EVIDENT_AGENT_KEY` — An agent key. When set, `evident run` authenticates as
107
- that agent and resolves the agent ID automatically, so `--agent` is not
108
+ - `EVIDENT_AGENT_KEY` — A runner key. When set, `evident run` authenticates as
109
+ that runner and resolves the runner ID automatically, so `--agent` is not
108
110
  required. Ideal for CI/CD.
109
111
  - `EVIDENT_TOKEN` — A user token used for authentication (alternative to a
110
112
  keychain login from `evident login`).
@@ -125,21 +127,21 @@ npm install -g @evident-ai/cli
125
127
  evident login
126
128
  ```
127
129
 
128
- ### 2. Create an agent
130
+ ### 2. Create a runner
129
131
 
130
- In the Evident web app, create an agent (it runs in local mode). Note its agent
132
+ In the Evident web app, create a runner (it runs in local mode). Note its runner
131
133
  ID.
132
134
 
133
135
  ### 3. Run it on your machine
134
136
 
135
- From your project directory, start the agent:
137
+ From your project directory, start the runner:
136
138
 
137
139
  ```bash
138
140
  evident run --agent <agent-id>
139
141
  ```
140
142
 
141
143
  `evident run` ensures `opencode serve` is running on `127.0.0.1:4096` (starting
142
- it if needed) and connects the tunnel. Once connected, the web shows the agent as
144
+ it if needed) and connects the tunnel. Once connected, the web shows the runner as
143
145
  online and you can open its chat.
144
146
 
145
147
  For CI or unattended use, set `EVIDENT_AGENT_KEY` and omit `--agent`:
@@ -166,7 +168,7 @@ EVIDENT_AGENT_KEY=<agent-key> evident run --idle-timeout 30
166
168
  2. It opens an outbound WebSocket to the Evident tunnel relay.
167
169
  3. Evident routes web traffic and channel (e.g. Slack) messages through the
168
170
  tunnel to your local OpenCode; responses flow back the same way.
169
- 4. Only one running copy of an agent is active at a time — starting a second copy
171
+ 4. Only one running copy of a runner is active at a time — starting a second copy
170
172
  takes over.
171
173
 
172
174
  See [ADR-0039](../../docs/decisions/0039-reuse-opencode-web-ui.md) and