Plumage
benjaminhuebner/Plumage
Workspace macOS nativo para Claude Code com Kanban, specs e agent embutido
Ver no GitHubWorkspace nativo para macOS que integra fluxos Claude Code com interface visual. Oferece Kanban para issues, editor de specs, agent embarcado e revisão local de PRs — tudo conectado ao CLI do Claude rodando como subprocess.
Instalação
npx convez-ai benjaminhuebner/Plumage1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerenciar issues e specs com Kanban visual durante workflows Claude Code
- Revisar e editar especificações de código em tempo real
- Executar o agent Claude Code em contexto integrado na aplicação
Veredito

Projeto experimental bem pensado que torna o workflow spec-driven do Claude Code mais navegável visualmente. Útil principalmente para desenvolvedores Swift em macOS que já usam Claude Code, mas sem suporte ou garantias de estabilidade — é um learning project antes de ser uma ferramenta pronta para produção.
README
A tradução para o português deste README ainda está na fila.
A native macOS workspace for Claude Code workflows.
Issues, specs, an embedded agent, and local PR review — the spec-driven loop you'd otherwise run blind in a terminal, given a real UI you can see, steer, and review.
[!IMPORTANT] Plumage is experimental, and a learning project first. I built it mainly to learn Claude Code — to get hands-on with a spec-driven workflow by living inside it in a real macOS app instead of just reading about it. It turned out useful, but it's a personal learning project first and a tool second. You're welcome to use it, fork it, or take ideas from it, but it ships with no support, no roadmap promises, and no stability guarantees. Expect rough edges.
Contents
About
Plumage integrates the Claude Code CLI: the claude binary runs as a subprocess,
and almost every interaction flows through it. But Plumage is far more than a
terminal front-end — it turns the entire spec-driven workflow into a native macOS
workspace, with a Kanban board for your issues, an integrated spec editor, the
agent docked right next to your work (as both a chat and a full terminal), and
local pull-request review.
It's meant to support the CLI, not replace it. The goal is simply to automate the workflow and make it easier to see and steer.
Who it's for
Plumage wraps a Claude Code workflow aimed primarily at Swift developers. The boundaries are kept deliberately loose, though: you can add your own templates and workflows to suit how you work. Nothing ties it to Swift or to any one skill set — that's just what it has been tested with.
Features
Embedded workflow
Plumage ships an opinionated, spec-driven workflow built right into the UI, instead
of leaving it to you to remember. Every issue carries three workflow actions — Plan,
Implement, and Review — surfaced as buttons on the issue itself. Each one runs a
slash-command in an embedded claude session scoped to that issue, and each advances the
spec's status along a typed lifecycle: draft → approved → in-progress → waiting-for-review → done.
The default workflow is fully integrated into the app, but it’s not rigid. If you prefer a different process, you can customize the workflow directly within Plumage.
The commands are defaults, not hardcoded. /plumage-plan, /plumage-implement, and
/plumage-review — along with the permission mode passed to claude for each — are fully
customizable per project and saved to <name>.plumage/config.json. Point them at your own
slash-commands and Plumage drives those instead.
A typical pass through it:
- Plan →
/plumage-plan <slug> - <prompt>interviews you in plan-mode, writes the spec, and sets its status toapproved. - Implement →
/plumage-implement <slug>works through the spec's tasks, commits per task behind a pre-commit gate, writes aPR.md, and moves the status towaiting-for-review. - Review → open the generated
PR.mdand the diff, then merge or reject against localgit. On merge, the status moves todoneand the branch becomes history.
Requirements
- macOS 26 or later.
- The
claudeCLI installed and on yourPATH(Plumage shells out to it — it does not bundle or replace it), signed in to a Claude Pro/Max subscription.
Built with
Plumage is a SwiftUI app with no runtime backend — it orchestrates local tools
(claude, git, swift-format) as subprocesses. Its third-party dependencies,
resolved via Swift Package Manager:
| Dependency | What it's for |
|---|---|
| Sparkle | In-app software updates |
| SwiftTerm | The embedded terminal |
| CodeEditorView | The integrated code & spec editor (pulls in Rearrange) |
| Yams | YAML parsing for issue-spec frontmatter |
Everything else is Apple frameworks (SwiftUI, AppKit bridges, Liquid Glass).
License
MIT © 2026 Benjamin Hübner