@gobing-ai/spur-cli 0.1.1

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 +44 -0
  2. package/dist/index.js +50564 -0
  3. package/package.json +62 -0
package/README.md ADDED
@@ -0,0 +1,44 @@
1
+ # @gobing-ai/spur-cli
2
+
3
+ **The `spur` command** — a local-first harness for mainstream coding agents (Claude Code, Codex,
4
+ Gemini CLI, Antigravity, pi, OpenCode, OpenClaw). Spur is **not** a coding agent; it wraps the agents
5
+ you already have with constraint checking, workflow orchestration, agent health checks, and
6
+ conversation-history analytics.
7
+
8
+ > **Runtime:** Spur is **Bun-native** (`bun >= 1.3.0`). Run it with `bunx`, or install globally under
9
+ > Bun. It does not run under plain Node today.
10
+
11
+ ## Install / run
12
+
13
+ ```bash
14
+ # Run ad-hoc (no install)
15
+ bunx @gobing-ai/spur-cli --help
16
+
17
+ # Install globally → use the `spur` command directly
18
+ bun install -g @gobing-ai/spur-cli
19
+ spur --help
20
+ ```
21
+
22
+ ## Usage
23
+
24
+ ```bash
25
+ spur init # scaffold .spur/ + seed global rules
26
+ spur rule run --preset recommended # evaluate constraint rules
27
+ spur workflow run <workflow.yaml> # run an FSM workflow
28
+ spur agent run "<prompt>" --agent auto # execute a prompt via a coding agent
29
+ spur agent doctor # check agent readiness
30
+ spur history import --source claude --root <path>
31
+ spur history analyze
32
+ spur status
33
+ ```
34
+
35
+ Every command supports `--json` for machine-readable output.
36
+
37
+ ## Documentation
38
+
39
+ Full docs, architecture, and the complete command surface live in the
40
+ [Spur repository](https://github.com/gobing-ai/spur).
41
+
42
+ ## License
43
+
44
+ Apache-2.0 © [Robin Min](mailto:minlongbing@gmail.com)