super-backlog 0.5.0 → 0.6.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/README.md +53 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,14 +19,41 @@ Superpowers and Backlog.md are strong on their own, but nothing wires them toget
|
|
|
19
19
|
|
|
20
20
|
## Quickstart
|
|
21
21
|
|
|
22
|
+
Install super-backlog into the current project with the official installer for your platform:
|
|
23
|
+
|
|
24
|
+
**Windows (PowerShell)** — bypasses Execution Policy automatically:
|
|
25
|
+
|
|
26
|
+
```powershell
|
|
27
|
+
irm https://raw.githubusercontent.com/adam-s-k-i/super-backlog/main/scripts/install.ps1 | iex
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**macOS / Linux**:
|
|
31
|
+
|
|
22
32
|
```bash
|
|
23
|
-
|
|
24
|
-
npm run board # open the Backlog.md kanban board
|
|
25
|
-
sbl dashboard --serve # live Project Dashboard on http://localhost:6428
|
|
26
|
-
# (or: npx super-backlog dashboard --serve)
|
|
33
|
+
curl -fsSL https://raw.githubusercontent.com/adam-s-k-i/super-backlog/main/scripts/install.sh | bash
|
|
27
34
|
```
|
|
28
35
|
|
|
29
|
-
|
|
36
|
+
Both installers check Node.js and npm, install `super-backlog`, and run `sbl init` without using `npx`, so they work even when `npx` is blocked by PowerShell's Execution Policy.
|
|
37
|
+
|
|
38
|
+
**Already have Node and npm?** You can also install manually without `npx`:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# Global install
|
|
42
|
+
npm install -g super-backlog
|
|
43
|
+
sbl init
|
|
44
|
+
sbl init --models
|
|
45
|
+
|
|
46
|
+
# Local install
|
|
47
|
+
npm install super-backlog
|
|
48
|
+
node ./node_modules/super-backlog/dist/cli.js init
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
After installation:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npm run board # open the Backlog.md kanban board
|
|
55
|
+
sbl dashboard --serve # live Project Dashboard on http://localhost:6428
|
|
56
|
+
```
|
|
30
57
|
|
|
31
58
|
`init` is idempotent — safe to re-run any time; re-running with a newer kit version is the upgrade path for all injected files.
|
|
32
59
|
|
|
@@ -47,7 +74,27 @@ On Windows PowerShell, `npx super-backlog init` may fail with an execution-polic
|
|
|
47
74
|
| `.git/hooks/post-commit` | dashboard freshness block — regenerates `dashboard.html` after commits that touch `backlog/` (default; opt out with `--no-refresh-hook`) | appended marker block |
|
|
48
75
|
| `.git/hooks/pre-commit` | integrity guard hook — only with `--guard` (opt-in) | appended marker block |
|
|
49
76
|
|
|
50
|
-
Commands: `sbl init` · `sbl doctor` · `sbl uninstall [--with-backlog]` · `sbl update` · `sbl dashboard [--serve] [--port <n>] [--no-open] [--out <file>]`. See `sbl help` for every flag.
|
|
77
|
+
Commands: `sbl init` · `sbl models` · `sbl doctor` · `sbl uninstall [--with-backlog]` · `sbl update` · `sbl dashboard [--serve] [--port <n>] [--no-open] [--out <file>]`. See `sbl help` for every flag.
|
|
78
|
+
|
|
79
|
+
## Model router (opt-in)
|
|
80
|
+
|
|
81
|
+
`sbl init --models` adds an optional model router that routes simple work to cheaper model tiers while keeping your main model for complex tasks.
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
sbl init --models # install router + harness adapters
|
|
85
|
+
sbl models enable # turn routing on
|
|
86
|
+
sbl models disable # turn routing off
|
|
87
|
+
sbl models show # inspect current config
|
|
88
|
+
sbl models discover # discover available OpenCode models
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
When enabled:
|
|
92
|
+
|
|
93
|
+
- **OpenCode** — the plugin `sbl-model-router.js` rewrites `chat.params` for the `sbl-worker` (workhorse) and `sbl-worker-cheap` / `explore` (budget) agents.
|
|
94
|
+
- **Claude Code** — agent files carry a `model:` placeholder that is updated by a `SessionStart` hook based on your current main model.
|
|
95
|
+
- **Dashboard** — `sbl dashboard --serve` exposes `/api/models` and `/api/models/discover`.
|
|
96
|
+
|
|
97
|
+
The router is fully owned by super-backlog and removed by `sbl uninstall`. See the [model router design](docs/superpowers/specs/2026-08-26-sbl-model-router-design.md) for details.
|
|
51
98
|
|
|
52
99
|
## Project Dashboard
|
|
53
100
|
|