Back to directory

genie

In a curated listMaintenance: Active

automagik-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.

View on GitHubHomepage
$ dsh plugin add genie

Install

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 work

354

stars

59

forks

TypeScript

Language

Apache-2.0

License

2025-08-01

Created

2026-11-20

Last push

README

Genie

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

Time-lapse of a real /wish run in Claude Code, from the task to an open pull request
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.md with 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

brainstorm wish

work review

council fix

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 contract
  • brainstorm: Settle an idea into a reviewed design
  • council: Pressure-test decisions through independent lenses
  • deslop: Clean up scoped prose, code or interface without losing meaning
  • docs: Audit docs and DX against the live product; write on request
  • fix: Repair review gaps with bounded retries
  • genie: Route or resume work only where Genie adds value
  • genie-hacks: Find grounded Genie workflow patterns and recipes
  • merge: Resolve a merge or rebase by intent, then re-run the gate
  • refine: Improve prompts for OpenAI or Claude
  • report: Diagnose a failure to root cause; file issues on request
  • research: Investigate against primary sources and cite every claim
  • review: Assess plans, code, PRs, and repository quality
  • skill-audit: Audit the skill catalogue for overlap, staleness, drift
  • verify: Prove completion with fresh gate, diff, and check output
  • wish: Deliver one task end to end, or plan a multi-group wish
  • work: Execute approved wishes with evidence
  • workfly: Build a saved workflow from a procedure

Workflows

Read the full README on GitHub →

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.