genie
In a curated listMaintenance: Activeautomagik-si/genie
Wishes in, PRs out. CLI agent that interviews you, plans the work, dispatches parallel agents in isolated worktrees, and reviews code before you see it.
$ dsh plugin add genieInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work354
stars
59
forks
TypeScript
Language
Apache-2.0
License
2025-08-01
Created
2026-11-20
Last push
README

Code is a commodity. Harnesses get replaced. Context stays.

A time-lapsed replay of a real /wish run, host details hidden and agent launch line removed. Its figures are one labelled sample, from its own genie wish report. Full video
Give /wish one decided task. It checks that the task fits, builds it in its own worktree, runs your repository's own check, has an agent that did not write the code review the exact commit, and opens a pull request. Merging stays with you.
curl -fsSL https://raw.githubusercontent.com/automagik-si/genie/main/install.sh | bash
Claude Code runs it as /wish, Codex as $wish, and other agents by name. Docs · Skills · Discord
One /wish from a real run, shortened:
You: /wish Delete dead code: src/lib/defaults.ts has no production callers
(only a type import of AgentDefaults in src/lib/workspace.ts) and
src/__tests__/dir-ls.test.ts reimplements a removed handler and asserts
on its own copy. Move the AgentDefaults type into workspace.ts, delete
defaults.ts, defaults.test.ts and dir-ls.test.ts.
Genie: I started the wish workflow in the background on branch
wish/delete-dead-defaults. It checks that the task fits a single wish,
makes the change in its own worktree, runs the full check, gets an
independent review and opens a PR against dev.
Genie: Review: SHIP. Checks: pass. The PR is open and its remote head matches the
local one. This run merged nothing. Merging is yours.
How it works
Designs and plans stay in your repository as markdown, with the reviews that approved them, so the next agent you use reads the same context. Each step is a skill. One decided task goes straight to wish. Anything bigger takes the whole loop, where every gate is run by an agent that did not do the work:
brainstorm → design review → wish → plan review → work → implementation review → PR
- brainstorm settles an idea into a
DESIGN.md. A design review approves it before any plan is written. - wish delivers one task end to end and returns a pull request ready for you to merge. Work bigger than one task becomes a
WISH.mdwith execution groups, and a plan review approves it before anything is built. - work runs the approved groups in dependency order, each with its own scoped worker, and ends at an implementation review.
- review runs those reviews. After work, it checks the result against the plan's criteria and returns SHIP, FIX-FIRST or BLOCKED. fix repairs the blocking gaps with bounded retries and a fresh reviewer.
- council sits beside the loop. It pressure-tests a decision through independent lenses and changes nothing.
Designs, plans and verdicts land in git under .genie/brainstorms/<slug>/ and .genie/wishes/<slug>/. Task state lives in one SQLite file per repository, .genie/genie.db, and genie board shows it as a kanban. Genie is built with Genie: this repository's own designs and plans are in .genie/brainstorms and .genie/wishes.
Skills
Genie v6.261003.1 ships 18 skills. The skill catalog groups them by category, and the Skills docs show a card for each one.
All 18 skills
authoring: Write a Genie skill that passes the shipped contractbrainstorm: Settle an idea into a reviewed designcouncil: Pressure-test decisions through independent lensesdeslop: Clean up scoped prose, code or interface without losing meaningdocs: Audit docs and DX against the live product; write on requestfix: Repair review gaps with bounded retriesgenie: Route or resume work only where Genie adds valuegenie-hacks: Find grounded Genie workflow patterns and recipesmerge: Resolve a merge or rebase by intent, then re-run the gaterefine: Improve prompts for OpenAI or Claudereport: Diagnose a failure to root cause; file issues on requestresearch: Investigate against primary sources and cite every claimreview: Assess plans, code, PRs, and repository qualityskill-audit: Audit the skill catalogue for overlap, staleness, driftverify: Prove completion with fresh gate, diff, and check outputwish: Deliver one task end to end, or plan a multi-group wishwork: Execute approved wishes with evidenceworkfly: Build a saved workflow from a procedure
Workflows
More in Agents, Automation & Workflows
dsh-agent-teams
by nanmicoder
AgentTeams 多智能体团队协作插件:自然语言驱动建团队、拉成员、拆任务声明依赖、成员间消息直达,Web 右上角活动面板
dsh-blender-plugin
by sixtysevenlf
Adds tools for Blender scene editing, viewport capture, render profiling, headless work, and verification.
dsh-free-search
by dddmuc
DSH 免费搜索插件,执行联网检索。
dsh-bili-scroll
by c1overzz
Schedules Bilibili discovery, reads subtitles, writes daily reports, and optionally posts a comment tagging you.
