nexos-connect 0.4.0 → 0.5.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.
Files changed (4) hide show
  1. package/README.md +18 -16
  2. package/dist/index.js +584 -266
  3. package/dist/index.js.map +1 -1
  4. package/package.json +2 -1
package/README.md CHANGED
@@ -15,10 +15,9 @@ One key, one model, one command.
15
15
 
16
16
  ---
17
17
 
18
- Claude Code, OpenAI Codex, OpenCode and GitHub Copilot CLI each keep their own config file, in their
19
- own format, with their own key names. **nexos-connect** finds the agents you have, shows exactly what
20
- it will change, backs up the originals, writes the configs, and reports the result — with your key
21
- masked.
18
+ Every coding agent keeps its own config file, in its own format, with its own key names.
19
+ **nexos-connect** finds the agents you have, shows exactly what it will change, backs up the
20
+ originals, writes the configs, and reports the result — with your key masked.
22
21
 
23
22
  - 🔍 **Detects** which agents are installed, and configures only those
24
23
  - 👀 **Shows the diff first** — `--dry-run` writes nothing at all
@@ -49,7 +48,7 @@ diff for every file:
49
48
  + "ANTHROPIC_AUTH_TOKEN": "nexos-0123…cdef",
50
49
  + …
51
50
  + },
52
- + "model": "auto-code[1m]"
51
+ + "model": "<model-id>"
53
52
  }
54
53
  ```
55
54
 
@@ -79,7 +78,7 @@ npx nexos-connect --dry-run
79
78
  npx nexos-connect --scope project
80
79
 
81
80
  # No questions asked — for scripts
82
- npx nexos-connect --harnesses claude-code,codex --key "$NEXOS_API_KEY" --model auto-code --yes
81
+ npx nexos-connect --harnesses claude-code,codex --key "$NEXOS_API_KEY" --yes
83
82
 
84
83
  # Try Claude Code on the gateway, leaving its config alone
85
84
  npx nexos-connect claude
@@ -88,21 +87,21 @@ npx nexos-connect claude
88
87
  npx nexos-connect codex -- exec "fix the tests"
89
88
  ```
90
89
 
91
- The default model is `auto-code`, the nexos.ai router that picks a model per request. Before the
92
- picker opens, nexos-connect checks that your key can use it, and offers the router only when that
93
- check passes. A check that fails, or one you skip with `--no-verify`, leaves it out. After a failed
94
- check you choose from the models your key can reach; with `--no-verify` you type a model id. A
95
- `--yes` run with no `--model` exits `2` only when the gateway rejected the router; anything less
96
- certain warns and uses it. Naming `auto-code` yourself always wins, with a warning only when the
97
- gateway rejected it, and the router is never saved as an agent's default. Save any other model your
98
- key can reach as an agent's default for next time.
90
+ The default model is the nexos.ai router, which picks a model per request. Before the picker opens,
91
+ nexos-connect checks that your key can use it, and offers the router only when that check passes. A
92
+ check that fails, or one you skip with `--no-verify`, leaves it out. After a failed check you choose
93
+ from the models your key can reach; with `--no-verify` you type a model id. A `--yes` run with no
94
+ `--model` exits `2` only when the gateway rejected the router; anything less certain warns and uses
95
+ it. Naming the router yourself always wins, with a warning only when the gateway rejected it, and
96
+ the router is never saved as an agent's default. Save any other model your key can reach as an
97
+ agent's default for next time.
99
98
 
100
99
  <details>
101
100
  <summary><b>All options</b></summary>
102
101
 
103
102
  | Option | Effect |
104
103
  | --------------------- | --------------------------------------------------------------------------------------------- |
105
- | `--harnesses <ids>` | Agents to set up: `claude-code`, `codex`, `opencode`, `copilot-cli` |
104
+ | `--harnesses <ids>` | Agents to set up: `claude-code`, `codex`, `opencode`, `copilot-cli`, `pi`, `crush`, `qwen-code` |
106
105
  | `--key <key>` | nexos.ai API key. Falls back to `$NEXOS_API_KEY`, then the saved key, then a prompt |
107
106
  | `--save-key` | Save the key in your system keychain for future runs |
108
107
  | `--model <id>` | Model every agent uses. Falls back to `$NEXOS_MODEL`, then the saved default, then a picker |
@@ -110,7 +109,7 @@ key can reach as an agent's default for next time.
110
109
  | `--scope <scope>` | `user` (default — your home directory) or `project` (this directory only) |
111
110
  | `-y`, `--yes` | Answer every question with its default and write without asking |
112
111
  | `--dry-run` | Show the diffs and write nothing |
113
- | `--no-verify` | Skip the gateway checks — key, model list and router — e.g. when offline. Without a check, `auto-code` is not offered |
112
+ | `--no-verify` | Skip the gateway checks — key, model list and router — e.g. when offline. Without a check, the router is not offered |
114
113
  | `--backup-dir <path>` | Where originals are copied. Default `~/.nexos/backups/`, or `./.nexos-backup/` for a project |
115
114
 
116
115
  Exit codes: `0` done · `1` an agent failed · `2` usage error · `130` cancelled.
@@ -127,6 +126,9 @@ Run `npx nexos-connect --help` for the full reference.
127
126
  | ------------------ | ---------------------------------------------- | ------------------------------ |
128
127
  | Claude Code | ✅ `~/.claude/settings.json` | ✅ `.claude/settings.local.json` |
129
128
  | OpenCode | ✅ `~/.config/opencode/opencode.json` | ✅ `opencode.json` |
129
+ | Pi | ✅ `~/.pi/agent/models.json` | — |
130
+ | Crush | ✅ `~/.config/crush/crush.json` | ✅ `.crush.json` |
131
+ | Qwen Code | ✅ `~/.qwen/settings.json` | ✅ `.qwen/settings.json` |
130
132
  | OpenAI Codex | ✅ `~/.codex/config.toml` + `~/.nexos/env` | — |
131
133
  | GitHub Copilot CLI | ✅ `~/.nexos/env` | — |
132
134
  | Gemini CLI | ❌ speaks a protocol the gateway does not serve | ❌ |