@cantinasecurity/apex-cli 0.1.18 → 0.1.19
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/.claude-plugin/marketplace.json +3 -3
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.mcp.claude.json +1 -1
- package/.mcp.codex.json +1 -1
- package/MARKETPLACE.md +1 -1
- package/README.md +12 -10
- package/dist/setup.js +2 -2
- package/package.json +1 -1
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
},
|
|
7
7
|
"metadata": {
|
|
8
8
|
"description": "Cantina agent plugins for security review workflows.",
|
|
9
|
-
"version": "0.1.
|
|
9
|
+
"version": "0.1.19"
|
|
10
10
|
},
|
|
11
11
|
"plugins": [
|
|
12
12
|
{
|
|
@@ -14,10 +14,10 @@
|
|
|
14
14
|
"source": {
|
|
15
15
|
"source": "npm",
|
|
16
16
|
"package": "@cantinasecurity/apex-cli",
|
|
17
|
-
"version": "0.1.
|
|
17
|
+
"version": "0.1.19"
|
|
18
18
|
},
|
|
19
19
|
"description": "Run Apex security scans and review findings from Claude Code.",
|
|
20
|
-
"version": "0.1.
|
|
20
|
+
"version": "0.1.19",
|
|
21
21
|
"author": {
|
|
22
22
|
"name": "Cantina",
|
|
23
23
|
"email": "support@cantina.xyz"
|
package/.mcp.claude.json
CHANGED
package/.mcp.codex.json
CHANGED
package/MARKETPLACE.md
CHANGED
|
@@ -13,7 +13,7 @@ This package is prepared as both a Claude Code plugin and a Codex plugin. The pu
|
|
|
13
13
|
The plugin MCP configs launch the pinned npm CLI package with:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
16
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex-mcp
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
That keeps marketplace installs independent of a user's global `apex` install.
|
package/README.md
CHANGED
|
@@ -141,30 +141,30 @@ unclaimed local trial proof so `apex claim` can still use it.
|
|
|
141
141
|
Agent-safe copy/paste prompt (substitute the issued code):
|
|
142
142
|
|
|
143
143
|
```text
|
|
144
|
-
Install and run Cantina Apex CLI 0.1.
|
|
144
|
+
Install and run Cantina Apex CLI 0.1.19 to start one free standard security scan of this repository immediately.
|
|
145
145
|
|
|
146
146
|
Use this trial code only where <TRIAL_CODE> appears below: SPBT-DEVREL-XXXXXXXX
|
|
147
147
|
|
|
148
148
|
Run the commands yourself from the repository root; do not stop after setup or only explain the steps. Use terminal CLI commands only. Do not use an Apex MCP tool or run `apex setup`, `apex mcp`, `apex login`, `apex-auth-start`, or `apex-auth-wait`. Never use `--replace` or `--force`.
|
|
149
149
|
|
|
150
150
|
Use this exact command prefix for every Apex command:
|
|
151
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
151
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex
|
|
152
152
|
|
|
153
153
|
1. Before redeeming, confirm every command will use the same persistent, user-accessible machine or container, HOME, filesystem, and repository root. Confirm Node.js 20+ and npx are available. If `APEX_BASE_URL` is set, continue only when its origin is `https://ai.cantina.xyz`. Run the exact prefix with `--help` and continue only if help lists both `redeem` and `claim`. If any check fails, STOP before sending the code; do not install system packages.
|
|
154
154
|
2. Redeem, with at most one response-loss recovery retry:
|
|
155
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
155
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex redeem <TRIAL_CODE> --json
|
|
156
156
|
This terminal command is the only allowed tool call containing the code. Never echo or restate the code, store it in a file or environment variable, put it in a URL or MCP call, or include it in your response. Continue when the command exits 0 and stdout is JSON with `redeemed: true` and `outcome` equal to `redeemed` or `idempotent`. If and only if the first attempt ends with an ambiguous transport/connection failure or an interrupted/missing response and no typed server error code, retry this exact same command once on the same machine, HOME, and repository root. Never retry a typed server rejection and never make more than one recovery retry. If the allowed retry does not return a successful JSON outcome, STOP.
|
|
157
157
|
3. Immediately start exactly one scan; do not wait for another instruction:
|
|
158
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
158
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex scan --mode standard --non-interactive --no-open --json
|
|
159
159
|
On any error or nonzero exit, STOP. After a successful scan JSON response, inspect `localPersistence.workspaceBindingSaved`. If it is `false`, the server scan already started: capture and report `binding.lastScanId`, then STOP; do not run status or findings until local repository permissions are repaired. Otherwise capture `binding.lastScanId` from the JSON as <SCAN_ID>; if it is absent, STOP.
|
|
160
160
|
4. About every 60 seconds, poll that exact scan:
|
|
161
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
161
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex status --scan <SCAN_ID> --json
|
|
162
162
|
Read `progress.progress.status`. Wait while it is `created`, `pending`, `queued`, `starting`, `running`, `in_progress`, or `processing`. Continue on `completed`. STOP on `failed`, `cancelled`, a missing or unknown status, or a command failure.
|
|
163
163
|
5. Fetch that exact scan's findings:
|
|
164
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
164
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex findings --scan <SCAN_ID> --json
|
|
165
165
|
On success, summarize findings by severity, most severe first, including identifier, title, status, and confidence. This command does not return file locations, so do not invent them. On failure, STOP.
|
|
166
166
|
6. Do not claim automatically. Tell me the claim deadline from step 2 and remind me to run this exact command myself from the same repository root, machine, and HOME:
|
|
167
|
-
npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
167
|
+
npx -y -p @cantinasecurity/apex-cli@0.1.19 apex claim
|
|
168
168
|
It may open a browser so I can create or sign in to a Cantina account and keep the results. The account must not already own a personal Apex tenant; if it does, tell me to contact Cantina support before the claim deadline because CLI linking is not available yet.
|
|
169
169
|
|
|
170
170
|
Never paste raw command transcripts. For any failure, report only the step, exit code, and sanitized error. Redact the trial code and every `apex_at_`, `apex_rt_`, or `apex_ct_` value from all reports.
|
|
@@ -420,9 +420,11 @@ claude mcp add --scope user \
|
|
|
420
420
|
For GitHub Copilot CLI:
|
|
421
421
|
|
|
422
422
|
```bash
|
|
423
|
-
copilot mcp add apex --
|
|
423
|
+
copilot mcp add apex --tools "*" -- apex-mcp
|
|
424
424
|
```
|
|
425
425
|
|
|
426
|
+
The command after `--` selects the local stdio transport; no version-specific transport flag is needed.
|
|
427
|
+
|
|
426
428
|
For any other MCP client, configure it to launch:
|
|
427
429
|
|
|
428
430
|
```json
|
|
@@ -526,7 +528,7 @@ Telemetry event posts do not include bearer tokens. The telemetry endpoint is `P
|
|
|
526
528
|
{
|
|
527
529
|
"schemaVersion": 1,
|
|
528
530
|
"event": "apex.invocation.completed",
|
|
529
|
-
"cliVersion": "0.1.
|
|
531
|
+
"cliVersion": "0.1.19",
|
|
530
532
|
"invocation": {
|
|
531
533
|
"surface": "mcp",
|
|
532
534
|
"command": "apex-scan",
|
|
@@ -557,7 +559,7 @@ The npm package also includes marketplace-ready plugin artifacts:
|
|
|
557
559
|
- `.claude-plugin/plugin.json` and `.mcp.claude.json` for Claude Code plugin installs
|
|
558
560
|
- `.claude-plugin/marketplace.json` for a Claude marketplace entry backed by the public npm package
|
|
559
561
|
|
|
560
|
-
These plugin installs launch the pinned npm package with `npx -y -p @cantinasecurity/apex-cli@0.1.
|
|
562
|
+
These plugin installs launch the pinned npm package with `npx -y -p @cantinasecurity/apex-cli@0.1.19 apex-mcp`, so users do not need to install `apex` globally before enabling the plugin.
|
|
561
563
|
|
|
562
564
|
The repository also includes `.agents/plugins/marketplace.json` for local Codex marketplace testing from a checkout.
|
|
563
565
|
|
package/dist/setup.js
CHANGED
|
@@ -300,12 +300,12 @@ async function configureCopilot(launch) {
|
|
|
300
300
|
if (existing) {
|
|
301
301
|
await execText("copilot", ["mcp", "remove", MCP_SERVER_NAME]);
|
|
302
302
|
}
|
|
303
|
+
// A command after `--` selects local stdio without relying on Copilot's renamed
|
|
304
|
+
// transport flag (`--type` in older releases, `--transport` in newer ones).
|
|
303
305
|
await execText("copilot", [
|
|
304
306
|
"mcp",
|
|
305
307
|
"add",
|
|
306
308
|
MCP_SERVER_NAME,
|
|
307
|
-
"--type",
|
|
308
|
-
"stdio",
|
|
309
309
|
"--tools",
|
|
310
310
|
"*",
|
|
311
311
|
"--",
|