@drip-apex/apex-cli 0.1.1 → 0.2.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/AGENTS.md +48 -0
- package/LICENSE +21 -0
- package/README.md +26 -25
- package/dist/cli.js +6963 -2883
- package/package.json +8 -3
- package/skills/apex-cli/SKILL.md +45 -0
package/package.json
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@drip-apex/apex-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"license": "MIT",
|
|
4
5
|
"description": "Apex CLI for managing experiments, approved roadmap ideas, and draft workspaces.",
|
|
5
6
|
"private": false,
|
|
6
7
|
"repository": {
|
|
7
8
|
"type": "git",
|
|
8
|
-
"url": "git+https://github.com/
|
|
9
|
+
"url": "git+https://github.com/drip-apex-labs/Apex.git",
|
|
9
10
|
"directory": "packages/cli"
|
|
10
11
|
},
|
|
11
12
|
"bin": {
|
|
@@ -14,12 +15,16 @@
|
|
|
14
15
|
},
|
|
15
16
|
"files": [
|
|
16
17
|
"dist",
|
|
18
|
+
"AGENTS.md",
|
|
19
|
+
"skills",
|
|
17
20
|
"README.md",
|
|
18
21
|
"package.json"
|
|
19
22
|
],
|
|
20
23
|
"scripts": {
|
|
21
24
|
"build": "esbuild src/cli.ts --bundle --platform=node --target=node18 --format=cjs --outfile=dist/cli.js --banner:js='#!/usr/bin/env node' --external:esbuild --external:fsevents",
|
|
25
|
+
"check:docs-command-index": "node scripts/check-docs-command-index.mjs",
|
|
22
26
|
"dev": "tsx src/cli.ts",
|
|
27
|
+
"test": "npm run build && node --test \"test/**/*.test.mjs\"",
|
|
23
28
|
"typecheck": "tsc --noEmit"
|
|
24
29
|
},
|
|
25
30
|
"engines": {
|
|
@@ -37,7 +42,7 @@
|
|
|
37
42
|
},
|
|
38
43
|
"devDependencies": {
|
|
39
44
|
"@types/node": "^22.15.0",
|
|
40
|
-
"tsx": "^4.
|
|
45
|
+
"tsx": "^4.22.4",
|
|
41
46
|
"typescript": "^5.6.3"
|
|
42
47
|
}
|
|
43
48
|
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: apex-cli
|
|
3
|
+
description: Use the Apex CLI to build, inspect, QA, and hand off Apex experiments from a shell-capable agent.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Apex CLI
|
|
7
|
+
|
|
8
|
+
Start by asking the installed CLI for its live contract:
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
apex schema --json
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Prefer JSON output. When stdout is piped, Apex emits JSON by default.
|
|
15
|
+
|
|
16
|
+
## Build Loop
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
apex experiments pull <id-or-slug> --dir <folder>
|
|
20
|
+
apex experiments plan <folder> --json
|
|
21
|
+
apex experiments apply <folder> --json
|
|
22
|
+
apex experiments qa status <folder> --json
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Edit only supported experiment files. Never hand-edit `qa.json` or `launch.json`.
|
|
26
|
+
|
|
27
|
+
## Launch Policy
|
|
28
|
+
|
|
29
|
+
Launch stays dashboard-only. Agents can build, apply, and collect QA evidence,
|
|
30
|
+
but a human must launch from the dashboard approval surface.
|
|
31
|
+
|
|
32
|
+
## Exit Codes
|
|
33
|
+
|
|
34
|
+
- `0`: ok
|
|
35
|
+
- `1`: general
|
|
36
|
+
- `2`: auth
|
|
37
|
+
- `3`: validation
|
|
38
|
+
- `4`: confirmation required; inspect `error.details.retry`
|
|
39
|
+
- `5`: conflict
|
|
40
|
+
|
|
41
|
+
## Headless Behavior
|
|
42
|
+
|
|
43
|
+
Do not wait for prompts in CI or agent runs. If a command returns exit `4`,
|
|
44
|
+
rerun with the exact flag named in the JSON error details only after checking
|
|
45
|
+
the plan or destructive action.
|