@xevy/cli 0.1.8 → 0.1.9

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 (3) hide show
  1. package/README.md +23 -14
  2. package/bin/xevy.mjs +51 -34
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -45,7 +45,7 @@ This walks you through everything:
45
45
 
46
46
  1. Installs the **pi agent** if it isn't already on your PATH.
47
47
  2. Installs the Xevy extensions (see [`xevy setup`](#xevy-setup) for details).
48
- 3. Installs the Xevy **SDLC skills** for Claude Code / Cursor / Codex (via `@xevy/skills`).
48
+ 3. Installs the Xevy **SDLC skills and MCP server** for Cursor, Claude Code, and Codex by default (via `@xevy/skills`). Pass repeatable `--agent <name>` flags to target any other agent supported by the underlying installers.
49
49
  4. Asks for your **API key**. When prompted, open the link it prints — it takes you
50
50
  straight to **Settings → Profile → API keys** at
51
51
  <https://xevy.ai/settings?section=profile&tab=api> — click **Create key**, copy the
@@ -66,7 +66,7 @@ That's it — you're set up. The sections below are reference for when you need
66
66
  Keep the Xevy extensions and SDLC skills current (run after Xevy releases):
67
67
 
68
68
  ```bash
69
- xevy check # is a newer skills version available?
69
+ xevy check # newer skills or missing coding-agent targets?
70
70
  xevy update # refresh the pi extensions + the SDLC skills
71
71
  ```
72
72
 
@@ -87,10 +87,11 @@ npm update -g @xevy/cli # or re-run: npm install -g @xevy/cli
87
87
  3. Asks for your **API key** (reuses an already-saved one if present) and prints a
88
88
  **direct link to the API-keys tab** to generate one, then stores it in
89
89
  `~/.config/xevy/credentials` (mode `600`, never printed).
90
- 4. Installs the Xevy **SDLC skills** into `.claude/skills`, `.cursor/skills`, etc.
91
- (delegates to `@xevy/skills` — skills only; the MCP tools for pi are already
92
- wired through the extensions above). A skills hiccup only warns; it never aborts
93
- the setup that already succeeded.
90
+ 4. Installs the Xevy **SDLC skills and MCP server configuration** for Cursor,
91
+ Claude Code, and Codex by default (delegates to `@xevy/skills`). pi keeps its
92
+ extension-backed MCP connection, so the coding-agent configuration does not
93
+ conflict with pi. An integration hiccup only warns; it never aborts the setup
94
+ that already succeeded.
94
95
 
95
96
  The API-keys link opens **Settings → Profile → API keys** directly:
96
97
  `https://xevy.ai/settings?section=profile&tab=api`.
@@ -99,11 +100,12 @@ The API-keys link opens **Settings → Profile → API keys** directly:
99
100
 
100
101
  ```bash
101
102
  xevy update # re-download the pi extensions + update the SDLC skills
102
- xevy check # report whether newer SDLC skills are available (exit 2 = update available)
103
+ xevy check # report skill updates or missing agent targets (exit 2 = update needed)
103
104
  ```
104
105
 
105
- `update` refreshes the extensions from the server and the skills via `@xevy/skills`;
106
- your saved API key is left untouched. Both accept `--base <url>` for self-hosted hosts.
106
+ `update` refreshes the extensions from the server and the skills + MCP configuration
107
+ via `@xevy/skills`; your saved API key is left untouched. These commands accept
108
+ `--base <url>` for self-hosted hosts and repeatable `--agent <name>` overrides.
107
109
 
108
110
  ## `xevy`
109
111
 
@@ -119,17 +121,24 @@ xevy "summarise this repo" # forwards the prompt to pi
119
121
 
120
122
  ```
121
123
  --base <url> Xevy host (default: XEVY_BASE or https://xevy.ai)
124
+ -a, --agent <name> Coding-agent target (repeatable; default: cursor, claude-code, codex)
122
125
  -v, --version Print the CLI version
123
126
  -h, --help Show help
124
127
  ```
125
128
 
126
129
  ## Skills & MCP for other agents
127
130
 
128
- `xevy setup` already installs the Xevy **SDLC skills** for **Cursor, Claude Code, and
129
- [50+ other agents](https://github.com/vercel-labs/skills#supported-agents)**. To also
130
- register the **Xevy MCP server** in those clients (pi gets it via the extensions), add
131
- it over OAuth (Cursor: Settings → MCP → `xevy`; Claude Code: browser sign-in on first
132
- use) or run the sibling package's MCP step:
131
+ `xevy setup` installs the Xevy **SDLC skills and MCP server** for **Cursor, Claude
132
+ Code, and Codex** by default. Target any identifier supported by
133
+ [`skills`](https://github.com/vercel-labs/skills#supported-agents) and `add-mcp` with
134
+ repeatable flags, for example `xevy setup -a windsurf -a codex`.
135
+
136
+ After installation, complete OAuth in each client. For Codex, run
137
+ `codex mcp login xevy` and restart the session. In Claude Code, run `/mcp` and
138
+ authenticate `xevy`. In Cursor, use Settings → MCP → `xevy` → Connect. Other
139
+ clients expose an equivalent MCP connect/OAuth action.
140
+
141
+ You can also run the sibling package directly:
133
142
 
134
143
  ```bash
135
144
  npx @xevy/skills mcp # register the Xevy MCP server, global by default
package/bin/xevy.mjs CHANGED
@@ -4,10 +4,10 @@
4
4
  *
5
5
  * xevy setup Install the pi agent (if missing); install the Xevy extensions
6
6
  * (core + model + MCP globally, xevy.ts into ~/.xevy/extensions);
7
- * install the Xevy SDLC skills (via @xevy/skills); and store your
8
- * API key.
9
- * xevy update Refresh the pi extensions + the Xevy SDLC skills.
10
- * xevy check Report whether newer Xevy SDLC skills are available.
7
+ * install the Xevy SDLC skills + MCP for coding agents (via
8
+ * @xevy/skills); and store your API key.
9
+ * xevy update Refresh the pi extensions + coding-agent integration.
10
+ * xevy check Report skill updates or missing coding-agent targets.
11
11
  * xevy Open pi with the Xevy extensions.
12
12
  *
13
13
  * `xevy setup` fetches the extensions from the server and asks for an API key
@@ -52,6 +52,10 @@ function apiKeysUrl(base) {
52
52
  return `${base}/settings?section=profile&tab=api`;
53
53
  }
54
54
 
55
+ function configuredAgentLabel(agents) {
56
+ return agents.length > 0 ? agents.join(", ") : "Cursor, Claude Code, Codex";
57
+ }
58
+
55
59
  function readCliVersion() {
56
60
  try {
57
61
  const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf-8"));
@@ -70,12 +74,14 @@ function usage() {
70
74
  console.log(`Xevy CLI
71
75
 
72
76
  xevy Open pi with the Xevy extensions in ~/.xevy/extensions
73
- xevy setup [--base u] Install pi (if missing) + the Xevy extensions + SDLC skills, store your API key
74
- xevy update [--base u] Refresh the pi extensions + the Xevy SDLC skills
75
- xevy check [--base u] Report whether newer Xevy SDLC skills are available
77
+ xevy setup [--base u] Install pi + extensions + coding-agent skills/MCP, store your API key
78
+ xevy update [--base u] Refresh the pi extensions + coding-agent skills/MCP
79
+ xevy check [--base u] Report skill updates or missing coding-agent targets
76
80
 
77
81
  Options:
78
82
  --base <url> Xevy host (default: XEVY_BASE or ${DEFAULT_BASE})
83
+ -a, --agent <name> Target any supported coding agent (repeatable)
84
+ Default: cursor, claude-code, codex
79
85
  -v, --version Print the CLI version
80
86
  -h, --help Show this help
81
87
 
@@ -102,7 +108,7 @@ function parseArgv(argv) {
102
108
 
103
109
  if (first === "setup" || first === "update" || first === "check") {
104
110
  const command = args.shift();
105
- const opts = { command, base, piArgs: [] };
111
+ const opts = { command, base, agents: [], piArgs: [] };
106
112
  while (args.length > 0) {
107
113
  const a = args.shift();
108
114
  if (a === "--base") {
@@ -111,6 +117,12 @@ function parseArgv(argv) {
111
117
  opts.base = v.replace(/\/$/, "");
112
118
  continue;
113
119
  }
120
+ if (a === "-a" || a === "--agent") {
121
+ const v = args.shift();
122
+ if (!v) die("Missing value for --agent");
123
+ if (!opts.agents.includes(v)) opts.agents.push(v);
124
+ continue;
125
+ }
114
126
  die(`Unknown option for \`xevy ${command}\`: ${a}. Try \`xevy --help\`.`);
115
127
  }
116
128
  return opts;
@@ -147,21 +159,22 @@ function ensurePi() {
147
159
  }
148
160
  }
149
161
 
150
- // Install the Xevy SDLC skills (into .claude/skills, .cursor/skills, etc.) via
151
- // the published @xevy/skills package. Skills only — the pi tools + MCP are
152
- // already wired through the extensions above and the stored credentials, so we
153
- // skip add-mcp here. Non-fatal: the core pi setup has already succeeded, so a
154
- // skills hiccup warns with the manual command instead of aborting.
155
- function installSkills(base) {
156
- const args = ["--yes", "@xevy/skills", "skills", "-y"];
162
+ // Install/update the portable Xevy skills and MCP configuration through the
163
+ // published @xevy/skills package. pi keeps its own extension-backed MCP path;
164
+ // the MCP install here targets external coding agents and does not conflict
165
+ // with pi. Non-fatal: core pi setup has already succeeded, so an integration
166
+ // hiccup warns with the manual command instead of aborting.
167
+ function installAgentIntegration(base, agents, packageCommand) {
168
+ const args = ["--yes", "@xevy/skills", packageCommand, "-y"];
157
169
  if (base !== DEFAULT_BASE) args.push("--base", base);
158
- const label = "npx @xevy/skills skills (Xevy SDLC skills)";
170
+ for (const agent of agents) args.push("-a", agent);
171
+ const label = `npx @xevy/skills ${packageCommand} (coding-agent skills + MCP)`;
159
172
  console.log(`→ ${label}`);
160
173
  const command = isWindows ? "npx.cmd" : "npx";
161
174
  const r = spawnSync(command, args, { stdio: "inherit", shell: isWindows, env: process.env });
162
175
  if (r.error || r.status !== 0) {
163
- console.warn(`⚠ Could not install Xevy skills (${r.error ? r.error.message : `exit ${r.status}`}).`);
164
- console.warn(" Install them later with: npx @xevy/skills skills -y");
176
+ console.warn(`⚠ Could not configure coding agents (${r.error ? r.error.message : `exit ${r.status}`}).`);
177
+ console.warn(" Configure them later with: npx @xevy/skills -y");
165
178
  return false;
166
179
  }
167
180
  return true;
@@ -299,49 +312,53 @@ async function setup(opts) {
299
312
  writeCredentials(opts.base, token);
300
313
  console.log(`✓ API key stored at ${CREDENTIALS_FILE} (key not shown).`);
301
314
 
302
- // 4. SDLC skills — install the Xevy agent skills so Claude Code / Cursor /
303
- // Codex pick them up alongside pi.
304
- const skillsOk = installSkills(opts.base);
315
+ // 4. Portable coding-agent integration. With no explicit -a flags, the
316
+ // @xevy/skills package applies its cursor + claude-code + codex defaults.
317
+ const agentIntegrationOk = installAgentIntegration(opts.base, opts.agents, "install");
305
318
 
306
319
  console.log("\n✓ Setup complete.");
307
320
  console.log(" • Xevy models (xevy/auto, xevy/fast, …) + MCP tools are available in any pi session — no /login needed.");
308
321
  console.log(
309
- skillsOk
310
- ? " • Xevy SDLC skills installed for Claude Code / Cursor / Codex — refresh later with `xevy update`."
311
- : " • Xevy SDLC skills NOT installed — run `xevy update` to add them.",
322
+ agentIntegrationOk
323
+ ? ` • Coding-agent skills + MCP configured for ${configuredAgentLabel(opts.agents)}.`
324
+ : " • Coding-agent integration NOT configured — run `xevy update` to retry.",
312
325
  );
326
+ if (agentIntegrationOk) {
327
+ console.log(" • Complete MCP OAuth in each configured client using the instructions above.");
328
+ }
313
329
  console.log(" • Run `xevy` to open pi with the Xevy tools + models loaded.");
314
330
  console.log(" • Keep current with `xevy check` / `xevy update`.");
315
331
  if (opts.base !== DEFAULT_BASE) console.log(` • Host: ${opts.base}`);
316
332
  }
317
333
 
318
- // `xevy update` — refresh the pi extensions from the server AND update the SDLC
319
- // skills. This is the "update everything the CLI installed" command. Skills are
320
- // delegated to @xevy/skills (the source of truth); the API key is left as-is.
334
+ // `xevy update` — refresh the pi extensions and portable coding-agent
335
+ // integration. @xevy/skills remains the source of truth; the API key is left
336
+ // as-is.
321
337
  async function update(opts) {
322
338
  console.log("Updating Xevy\n");
323
339
 
324
340
  // 1. Re-download the pi extensions (they carry the date-stamped versions).
325
341
  await downloadAllExtensions(opts.base);
326
342
 
327
- // 2. Skills via @xevy/skills (single source of truth for SDLC skills).
328
- const skillsOk = installSkills(opts.base);
343
+ // 2. Skills + MCP via @xevy/skills.
344
+ const agentIntegrationOk = installAgentIntegration(opts.base, opts.agents, "update");
329
345
 
330
346
  console.log("\n✓ Update complete.");
331
347
  console.log(" • Xevy pi extensions refreshed.");
332
348
  console.log(
333
- skillsOk
334
- ? " • Xevy SDLC skills updated."
335
- : " • Xevy SDLC skills NOT updated — run `npx @xevy/skills update -y` manually.",
349
+ agentIntegrationOk
350
+ ? " • Coding-agent skills + MCP updated."
351
+ : " • Coding-agent integration NOT updated — run `npx @xevy/skills update -y` manually.",
336
352
  );
337
353
  if (opts.base !== DEFAULT_BASE) console.log(` • Host: ${opts.base}`);
338
354
  }
339
355
 
340
- // `xevy check` — is a newer SDLC-skills version available? Delegates to the
341
- // @xevy/skills version check (which reads the install stamp + npm/manifest).
356
+ // `xevy check` — is a newer skills version available, or is a requested agent
357
+ // target missing? Delegates to @xevy/skills (install stamp + npm/manifest).
342
358
  function check(opts) {
343
359
  const args = ["--yes", "@xevy/skills", "check"];
344
360
  if (opts.base !== DEFAULT_BASE) args.push("--base", opts.base);
361
+ for (const agent of opts.agents) args.push("-a", agent);
345
362
  const command = isWindows ? "npx.cmd" : "npx";
346
363
  const r = spawnSync(command, args, { stdio: "inherit", shell: isWindows, env: process.env });
347
364
  // Preserve @xevy/skills' exit code (0 = current, 2 = update available, …).
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@xevy/cli",
3
- "version": "0.1.8",
4
- "description": "Xevy CLI — `xevy setup` installs the pi agent, the Xevy pi extensions, and the SDLC skills, and stores your API key; `xevy update`/`xevy check` keep them current; `xevy` opens pi with it.",
3
+ "version": "0.1.9",
4
+ "description": "Xevy CLI — `xevy setup` installs pi, Xevy extensions, and coding-agent skills + MCP, then stores your API key; `xevy update`/`xevy check` keep them current; `xevy` opens pi with it.",
5
5
  "type": "module",
6
6
  "keywords": [
7
7
  "xevy",