@automagik/genie 4.260402.19 → 4.260403.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 (7) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.github/workflows/release.yml +3 -3
  3. package/.github/workflows/version.yml +2 -2
  4. package/README.md +119 -66
  5. package/package.json +1 -1
  6. package/plugins/genie/.claude-plugin/plugin.json +1 -1
  7. package/plugins/genie/package.json +1 -1
package/.claude-plugin/marketplace.json CHANGED
@@ -10,7 +10,7 @@
10
10
  "plugins": [
11
11
  {
12
12
  "name": "genie",
13
- "version": "4.260402.19",
13
+ "version": "4.260403.1",
14
14
  "source": "./plugins/genie",
15
15
  "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
16
16
  }
package/.github/workflows/release.yml CHANGED
@@ -31,9 +31,9 @@ jobs:
31
31
  echo "Release ${TAG} already exists — deriving hotfix version."
32
32
  TODAY=$(date -u +%y%m%d)
33
33
  EXISTING=$(gh release list --limit 100 --json tagName \
34
- -q "[.[].tagName | select(startswith(\"v3.${TODAY}.\"))] | length")
34
+ -q "[.[].tagName | select(startswith(\"v4.${TODAY}.\"))] | length")
35
35
  BUILD=$((EXISTING + 1))
36
- VERSION="3.${TODAY}.${BUILD}"
36
+ VERSION="4.${TODAY}.${BUILD}"
37
37
  echo "Hotfix version: v${VERSION}"
38
38
  echo "hotfix=true" >> "$GITHUB_OUTPUT"
39
39
  else
@@ -77,7 +77,7 @@ jobs:
77
77
  run: |
78
78
  TAG="${{ steps.ver.outputs.tag }}"
79
79
  if [ -z "$RELEASE_NOTES" ]; then
80
- RELEASE_NOTES="Initial release of genie v3 CLI."
80
+ RELEASE_NOTES="Initial release of genie v4 CLI."
81
81
  fi
82
82
  printf '%s' "$RELEASE_NOTES" > /tmp/release-notes.md
83
83
  if gh release view "${TAG}" > /dev/null 2>&1; then
package/.github/workflows/version.yml CHANGED
@@ -39,14 +39,14 @@ jobs:
39
39
  BRANCH="${{ github.event.workflow_run.head_branch || 'dev' }}"
40
40
  if [ "$BRANCH" = "main" ]; then
41
41
  echo "branch=dev" >> "$GITHUB_OUTPUT"
42
- echo "prefix=3" >> "$GITHUB_OUTPUT"
42
+ echo "prefix=4" >> "$GITHUB_OUTPUT"
43
43
  echo "npm_tag=latest" >> "$GITHUB_OUTPUT"
44
44
  else
45
45
  echo "branch=dev" >> "$GITHUB_OUTPUT"
46
46
  echo "prefix=4" >> "$GITHUB_OUTPUT"
47
47
  echo "npm_tag=next" >> "$GITHUB_OUTPUT"
48
48
  fi
49
- echo "Resolved: branch=dev, prefix=$([ "$BRANCH" = "main" ] && echo 3 || echo 4)"
49
+ echo "Resolved: branch=dev, prefix=4"
50
50
 
51
51
  - uses: actions/checkout@v4
52
52
  with:
package/README.md CHANGED
@@ -5,106 +5,159 @@
5
5
  </p>
6
6
 
7
7
  <p align="center">
8
- <a href="https://www.npmjs.com/package/@automagik/genie"><img alt="npm version" src="https://img.shields.io/npm/v/@automagik/genie?style=flat-square&color=00D9FF" /></a>
9
- <a href="https://github.com/automagik-dev/genie"><img alt="GitHub" src="https://img.shields.io/github/stars/automagik-dev/genie?style=flat-square&color=00D9FF" /></a>
10
- <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/automagik-dev/genie?style=flat-square&color=00D9FF" /></a>
11
- <a href="https://discord.gg/xcW8c7fF3R"><img alt="Discord" src="https://img.shields.io/discord/1095114867012292758?style=flat-square&color=00D9FF&label=discord" /></a>
8
+ <strong>Wishes in, PRs out.</strong>
12
9
  </p>
13
10
 
14
- <h2 align="center">Wishes in, PRs out.</h2>
15
-
16
- <!-- METRICS:START -->
11
+ <p align="center">
12
+ <a href="https://www.npmjs.com/package/@automagik/genie"><img alt="npm" src="https://img.shields.io/npm/v/@automagik/genie?style=flat-square&color=00D9FF" /></a>
13
+ <a href="https://www.npmjs.com/package/@automagik/genie"><img alt="downloads" src="https://img.shields.io/npm/dm/@automagik/genie?style=flat-square&color=00D9FF" /></a>
14
+ <a href="https://github.com/automagik-dev/genie/stargazers"><img alt="stars" src="https://img.shields.io/github/stars/automagik-dev/genie?style=flat-square&color=00D9FF" /></a>
15
+ <a href="LICENSE"><img alt="license" src="https://img.shields.io/github/license/automagik-dev/genie?style=flat-square&color=00D9FF" /></a>
16
+ <a href="https://discord.gg/xcW8c7fF3R"><img alt="discord" src="https://img.shields.io/discord/1095114867012292758?style=flat-square&color=00D9FF&label=discord" /></a>
17
+ </p>
17
18
 
18
- | Metric | Value | Updated |
19
- |--------|-------|---------|
20
- | Releases/day | **0** | 2026-03-31 |
21
- | Avg merge time | **0.3h** | 2026-03-31 |
22
- | SHIP rate | **85%** | 2026-03-31 |
23
- | Merged PRs (7d) | **35** | 2026-03-31 |
19
+ <br />
24
20
 
25
- <!-- METRICS:END -->
21
+ <!-- TODO: Record a 30s terminal demo with vhs/asciinema and uncomment:
22
+ <p align="center">
23
+ <img src=".github/assets/genie-demo.gif" alt="Genie demo" width="720" />
24
+ </p>
25
+ -->
26
26
 
27
- ## What is Genie?
27
+ Genie is a CLI that turns one sentence into a finished pull request. You describe what you want — Genie interviews you, writes a plan, spawns parallel agents in isolated worktrees, reviews the code, and opens a PR. You approve. You merge. That's it.
28
28
 
29
- Genie is an AI orchestration CLI that turns vague ideas into shipped PRs. You describe the problem — Genie interviews you, plans the work, dispatches parallel agents, and reviews the code. You approve and ship.
29
+ ## Get started
30
30
 
31
- ## Get Started
31
+ Paste this into Claude Code, Codex, or any AI coding agent:
32
32
 
33
- **Prerequisites:** curl, bash, git (pre-installed on macOS/Linux/WSL)
33
+ ```
34
+ Install Genie and set up this project:
34
35
 
35
- ```bash
36
36
  curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
37
37
  genie
38
38
  /wizard
39
39
  ```
40
40
 
41
- The wizard handles everything: project scaffold, identity, first wish, execution, and review.
41
+ That's it. The wizard interviews you, scaffolds your project, and walks you through your first wish. Relax.
42
42
 
43
- ## How It Works
43
+ Or install manually:
44
44
 
45
+ ```bash
46
+ curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
45
47
  ```
46
- You describe an idea
47
- └─ /brainstorm ─── Genie asks clarifying questions until the idea is concrete
48
- └─ /wish ───── Crystallizes intent into a plan with scope + acceptance criteria
49
- └─ /work ── Agents spawn in isolated worktrees, execute in parallel
50
- └─ /review ── Automated severity-gated review. You approve the PR.
48
+
49
+ ## What you get
50
+
51
+ ```
52
+ "Add dark mode"
53
+ |
54
+ /brainstorm ──── Genie asks questions until the idea is concrete
55
+ |
56
+ /wish ────────── Turns it into a plan: scope, criteria, task groups
57
+ |
58
+ /work ────────── Agents spawn in parallel worktrees, each on its own branch
59
+ |
60
+ /review ──────── 10 critics review. Severity-tagged. Nothing ships dirty.
61
+ |
62
+ Pull Request ─── You approve. You merge. Ship it.
51
63
  ```
52
64
 
53
- ## Features
65
+ **Parallel agents.** Not one agent doing everything sequentially — multiple agents working at the same time in isolated worktrees. No conflicts. No re-explaining context.
54
66
 
55
- ### Orchestration
56
- - **Wish pipeline** — Brainstorm, plan, execute, review, ship. One continuous flow.
57
- - **Parallel agents** — Multiple agents work simultaneously in isolated worktrees.
58
- - **Automated review** — Severity-tagged gaps. Nothing ships with CRITICAL issues.
59
- - **10-critic council** — 10 specialist perspectives critique your design before you commit.
60
- - **Overnight mode** — Queue wishes before bed. Wake up to reviewed PRs.
67
+ **Automated review.** A 10-critic council (architecture, security, DX, performance, ops, and more) reviews every design before you see it. Severity-tagged findings. CRITICAL blocks the PR.
61
68
 
62
- ### Task Management
63
- - **Boards** — Kanban-style pipelines with columns, gates, and WIP limits. Create from templates or build your own.
64
- - **Tasks** — Full lifecycle: create, assign, move through stages (`draft` → `brainstorm` → `wish` → `build` → `review` → `qa` → `ship`), block/unblock, add dependencies.
65
- - **Projects** — Named task boards that scope work to a specific initiative.
66
- - **Tags, types, releases** — Organize tasks with custom tags, define task types with stage pipelines, group work into releases.
69
+ **Overnight mode.** `/dream` — queue wishes before bed. Wake up to reviewed PRs.
67
70
 
68
- ### Observability
69
- - **Events** — Audit log with error aggregation, cost breakdown, tool analytics, and per-entity timelines.
70
- - **Metrics** — Machine snapshots, heartbeat history, per-agent resource usage.
71
- - **Sessions** — List, replay, and full-text search across Claude Code session transcripts.
72
- - **Unified log** — `genie log --follow` streams transcript, messages, tool calls, and state changes from the PG event log in one feed.
71
+ **Kanban boards.** Built-in task boards with custom pipelines and stage gates.
73
72
 
74
- ### Infrastructure
75
- - **Postgres-backed** — All state in PostgreSQL (pgserve). Tasks, messages, events, metrics — queryable with `genie db query`.
76
- - **Scheduling** — Cron-based triggers with a systemd daemon. Heartbeat collection and orphan reconciliation built in.
77
- - **Export/Import** — Full backup and restore across boards, tasks, tags, projects, schedules, agents, and conversations.
78
- - **PG messaging** — Direct messages, broadcasts, threaded conversations, and inbox — all persisted and searchable.
73
+ **Postgres-backed.** All state lives in PostgreSQL — agents, tasks, events, messages. Queryable. Durable. Real-time via LISTEN/NOTIFY.
79
74
 
80
- ### Developer Experience
81
- - **14 built-in skills** — `/brainstorm`, `/wish`, `/work`, `/review`, `/council`, `/dream`, `/trace`, `/fix`, `/report`, `/refine`, `/learn`, `/docs`, `/genie`, `/wizard`.
82
- - **BYOA** — Bring your own agent. Works with Claude, Codex, or any OpenAI-compatible provider.
83
- - **Portable context** — Identity, skills, memory — markdown files you own, git-versioned.
84
- - **QA system** — Self-testing specs with `genie qa run`. Validates CLI correctness continuously.
75
+ **Full observability.** Events, metrics, session replay, cost tracking. See everything your agents do.
85
76
 
86
- ### CLI at a Glance
77
+ **Portable context.** Identity, skills, memory — all markdown files in your repo, git-versioned. You own everything.
87
78
 
88
- 46 commands across agent lifecycle, task management, boards, observability, messaging, and infrastructure. [Full CLI reference →](https://docs.automagik.dev/genie/cli/session)
79
+ **Any AI provider.** Claude, Codex, or any OpenAI-compatible model. Bring your own agent.
89
80
 
90
- ```bash
91
- genie spawn engineer --model sonnet # Spawn an agent
92
- genie task create "Add dark mode" # Create a task
93
- genie board show # View your Kanban board
94
- genie events costs --last 24h # Check API spend
95
- genie log --follow --team my-team # Stream team activity
96
- genie export all -o backup.json # Full backup
97
- ```
81
+ ## Why Genie?
82
+
83
+ <table>
84
+ <tr>
85
+ <td width="50%">
86
+
87
+ ### Without Genie
88
+
89
+ - Re-explain context every new chat
90
+ - One agent, one file at a time
91
+ - Copy-paste PR descriptions manually
92
+ - Review AI code yourself, line by line
93
+ - Context lost mid-conversation
94
+ - No memory between sessions
95
+
96
+ </td>
97
+ <td width="50%">
98
+
99
+ ### With Genie
100
+
101
+ - Context captured once, inherited by every agent
102
+ - Parallel agents in isolated worktrees
103
+ - Automated severity-gated code review
104
+ - Queue wishes overnight, wake up to PRs
105
+ - 10-critic council catches what you'd miss
106
+ - Persistent memory across sessions
107
+
108
+ </td>
109
+ </tr>
110
+ </table>
111
+
112
+ ## Skills
113
+
114
+ 17 built-in skills that compose into workflows:
115
+
116
+ | Skill | What it does |
117
+ |-------|-------------|
118
+ | `/brainstorm` | Explore vague ideas with guided questions |
119
+ | `/wish` | Turn an idea into a scoped plan with acceptance criteria |
120
+ | `/work` | Execute a wish with parallel agents |
121
+ | `/review` | Severity-gated code review (SHIP or FIX-FIRST) |
122
+ | `/council` | 10-perspective architectural deliberation |
123
+ | `/dream` | Batch-execute wishes overnight |
124
+ | `/trace` | Investigate bugs — reproduce, isolate, root cause |
125
+ | `/fix` | Minimal targeted bug fixes |
126
+ | `/report` | Deep investigation with browser + trace |
127
+ | `/refine` | Transform rough prompts into structured specs |
128
+ | `/learn` | Correct agent behavior from mistakes |
129
+ | `/docs` | Audit and generate documentation |
130
+ | `/pm` | Full project management playbook |
131
+ | `/brain` | Knowledge graph with Obsidian-compatible vaults |
132
+ | `/genie` | Auto-router — natural language to the right skill |
133
+ | `/genie-hacks` | Community patterns and real-world workflows |
134
+ | `/wizard` | Guided first-run onboarding |
135
+
136
+ ## What's new in v4
137
+
138
+ v4 is a ground-up rewrite. 700 commits. 300 files. ~19K lines.
139
+
140
+ | | v3 | v4 |
141
+ |---|---|---|
142
+ | **State** | JSON files + NATS | PostgreSQL + LISTEN/NOTIFY |
143
+ | **UI** | CLI only | Full terminal UI |
144
+ | **Memory** | None | Optional knowledge brain |
145
+ | **Tasks** | Basic | Kanban boards, templates, projects |
146
+ | **Observability** | Minimal | OTLP, session capture, audit trail |
147
+ | **Review** | Single pass | 10-critic council deliberation |
148
+ | **Stability** | Best effort | Advisory locks, spawn watchdog, 200+ bug fixes |
149
+
150
+ [Full v4 release notes →](https://github.com/automagik-dev/genie/releases/tag/v4.260402.18)
98
151
 
99
152
  ---
100
153
 
101
154
  <p align="center">
102
- <a href="https://docs.automagik.dev/genie"><strong>Documentation</strong></a> &middot;
103
- <a href="https://github.com/automagik-dev/genie"><strong>GitHub</strong></a> &middot;
155
+ <a href="https://docs.automagik.dev/genie"><strong>Docs</strong></a> &middot;
156
+ <a href="https://github.com/automagik-dev/genie/releases/tag/v4.260402.18"><strong>v4 Release</strong></a> &middot;
104
157
  <a href="https://discord.gg/xcW8c7fF3R"><strong>Discord</strong></a> &middot;
105
158
  <a href="LICENSE"><strong>MIT License</strong></a>
106
159
  </p>
107
160
 
108
161
  <p align="center">
109
- <sub>You make the decisions. Genie does everything else.</sub>
162
+ <sub>You describe the problem. Genie does everything else.</sub>
110
163
  </p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@automagik/genie",
3
- "version": "4.260402.19",
3
+ "version": "4.260403.1",
4
4
  "description": "Collaborative terminal toolkit for human + AI workflows",
5
5
  "type": "module",
6
6
  "bin": {
package/plugins/genie/.claude-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "genie",
3
- "version": "4.260402.19",
3
+ "version": "4.260403.1",
4
4
  "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, turn them into wishes, execute with /work, validate with /review, and ship as one team.",
5
5
  "author": {
6
6
  "name": "Namastex Labs"
package/plugins/genie/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "genie-plugin",
3
- "version": "4.260402.19",
3
+ "version": "4.260403.1",
4
4
  "private": true,
5
5
  "description": "Runtime dependencies for genie bundled CLIs",
6
6
  "type": "module",