ur-agent 1.30.6 → 1.31.0

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.
package/docs/providers.md CHANGED
@@ -197,6 +197,33 @@ ur config set provider anthropic-api
197
197
  - Claude API and Claude Code are separate providers
198
198
  - Gemini API and Gemini CLI are separate providers
199
199
 
200
+ ### Connecting accounts (`ur connect` / `/connect`)
201
+
202
+ Connect a provider once from inside UR (or a terminal). The connection persists,
203
+ so you do not repeat it each session:
204
+
205
+ ```sh
206
+ ur connect status # connection state for every provider
207
+ ur connect codex-cli # subscription: launches the official login (Codex/Claude/Gemini)
208
+ echo "$OPENAI_API_KEY" | ur connect openai-api # API: store a key (from stdin, not shell history)
209
+ ur connect openai-api --key <KEY> # API: store a key explicitly
210
+ ur connect logout openai-api # clear a stored key
211
+ ```
212
+
213
+ - **Subscription providers** (`codex-cli`, `claude-code-cli`, `gemini-cli`,
214
+ `antigravity-cli`) connect through their official CLI login using your own
215
+ account; the session is persisted by that CLI. UR never scrapes or copies
216
+ those tokens.
217
+ - **API providers** (`openai-api`, `anthropic-api`, `gemini-api`, `openrouter`)
218
+ store the key in your OS keychain (macOS Keychain, with an encrypted file
219
+ fallback) — the same secure store UR uses for its own credentials. At runtime
220
+ a stored key is used first, then the provider's environment variable, so
221
+ setting the env var still works and never gets overwritten.
222
+
223
+ If you select a provider that is not connected, UR shows a connect prompt in
224
+ `/model` and the runtime fails clearly with the exact `ur connect <provider>`
225
+ command instead of silently switching providers.
226
+
200
227
  ### Validation
201
228
 
202
229
  When you set a model that is incompatible with the current provider, UR-AGENT shows an error:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ur-agent",
3
- "version": "1.30.6",
3
+ "version": "1.31.0",
4
4
  "description": "UR-AGENT — autonomous engineering workflow engine (plan, execute, test, verify, document, benchmark, reproduce)",
5
5
  "type": "module",
6
6
  "packageManager": "bun@1.3.14",