@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.
- package/README.md +23 -14
- package/bin/xevy.mjs +51 -34
- 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
|
|
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 #
|
|
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
|
|
91
|
-
(delegates to `@xevy/skills`
|
|
92
|
-
|
|
93
|
-
|
|
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
|
|
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
|
|
106
|
-
your saved API key is left untouched.
|
|
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`
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
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
|
|
8
|
-
* API key.
|
|
9
|
-
* xevy update Refresh the pi extensions +
|
|
10
|
-
* xevy check Report
|
|
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
|
|
74
|
-
xevy update [--base u] Refresh the pi extensions +
|
|
75
|
-
xevy check [--base u] Report
|
|
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
|
|
151
|
-
//
|
|
152
|
-
//
|
|
153
|
-
//
|
|
154
|
-
//
|
|
155
|
-
function
|
|
156
|
-
const args = ["--yes", "@xevy/skills",
|
|
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
|
|
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
|
|
164
|
-
console.warn("
|
|
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.
|
|
303
|
-
//
|
|
304
|
-
const
|
|
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
|
-
|
|
310
|
-
?
|
|
311
|
-
: " •
|
|
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
|
|
319
|
-
//
|
|
320
|
-
//
|
|
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
|
|
328
|
-
const
|
|
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
|
-
|
|
334
|
-
? " •
|
|
335
|
-
: " •
|
|
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
|
|
341
|
-
// @xevy/skills
|
|
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.
|
|
4
|
-
"description": "Xevy CLI — `xevy setup` installs
|
|
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",
|