flux
v1.43.0A complete, harness-neutral work cycle for Git repositories: probe, refine, issue, build, peek, review, iterate, land, and reply, chain to link them, plus map and equip, which prepare the machine and the repository.
By Gabriel GrippLicense: MIT5 GitHub starsUpdated 1 hour ago
Directory evidence
- Runtimes
- Codex and Claude Code
- Parsed components
- 12 skill or MCP entries
- Source updated
- Oct 1, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install flux for Codex and Claude Code
codex plugin marketplace add grippado/flux
codex plugin marketplace upgrade flux
codex plugin add flux@fluxPaste and run these commands in a terminal with Codex. They add and refresh the flux catalog, then install this plugin.
Compatibility: the page URL and API slug “flux” remain stable.
- Codex:
flux@agent-plugin-marketplace→flux@flux
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/grippado/fluxClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/flux/.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── skills/build/SKILL.md├── skills/chain/SKILL.md├── skills/equip/SKILL.md├── skills/issue/SKILL.md├── skills/iterate/SKILL.md├── skills/land/SKILL.md├── skills/map/SKILL.md├── skills/peek/SKILL.md├── skills/probe/SKILL.md├── skills/refine/SKILL.md├── skills/reply/SKILL.md└── skills/review/SKILL.md
Included Skills12
Orquestrador `flux:build` — elo de execução da família: recebe um ticket/descrição e um repo, e despacha para o motor de execução nativo daquele repo (`/workflow`), caindo no `exec_fallback` do perfil ou no modo autônomo quando o repo não tem motor próprio. Produz código + PR draft. Não reimplementa pipeline de implementação. Global, resolve contexto via `flux-context.md`. Local apenas — CI e Forja ficam fora.
Orquestrador `flux:chain` — encadeia elos da família por artefato (`review>iterate`): valida a gramática antes de rodar, recusa chain ilegal com o corte legal, passa o baton (PR, ticket, board) entre os elos e abre com um banner próprio. Cada elo mantém os próprios gates. Executa `review>iterate`; os demais chains legais valida e imprime o plano. Global, resolve contexto via `flux-context.md`.
Verbo de preparo `flux:equip` — equipa um repo com o que a família consome mas não produz sozinha: o motor de execução (L0) e a suite de specialists locais (L2). Único lugar onde o Bootstrap de specialists roda de fato; os outros elos passaram a oferecer este verbo em vez de duplicar a lógica. Toda escrita passa pelo contrato de destino (`write-destination.md`), nunca dentro do checkout do repo alvo, e escrever no manifesto é ação com gate próprio. Global, resolve contexto via `flux-context.md`.
Orquestrador `flux:issue` — gera issues de alta qualidade a partir de QUALQUER fonte (thread do Slack, texto livre, PR), embasadas em código real via os specialists do repo (o mesmo arsenal do review/iterate/delivery), com disciplina de links e escrita correta. Grava um rascunho revisável no vault e cria no Linear só após aprovação (HITL). Global, resolve contexto via `flux-context.md`.
Orquestrador `flux:iterate` — fecha o loop de UMA PR (checa se ela ainda funde com a base e resolve conflito mecânico, verifica threads contra o código real, aplica correções, responde, reage 👍/👎, resolve, commita, pusha, vigia CI + bot). `--dry` rascunha réplicas read-only e salva no vault. Global, resolve contexto via `flux-context.md`.
Orquestrador `flux:land` — orquestra a entrega multi-PR de uma issue/feature (descobre, ordena, valida regressão com specialists por default via review-agents.md, mantém merge-ready delegando ao `flux:iterate`, emite go/no-go). Global, resolve contexto via flux-context.json. NÃO mergeia. Complementa os comandos que criam PRs; este orquestra PRs já existentes até o merge. Workspace mode.
Verbo de sanidade `flux:map` — levanta a instalação inteira da família nesta máquina (raízes de agents, manifestos de contexto, repos conhecidos, as três lentes por repo, colisões de `name:`) e grava o índice que os demais elos consomem. Roda fora de qualquer trabalho: não revisa, não implementa, não toca repo alvo. Executando de novo, mostra o que mudou desde a última vez — agents novos, repos novos, lentes que quebraram — e só escreve depois do gate. Sugerido antes de tudo; obrigatório para nada.
Relance read-only de working tree / branch / diff / PR / doc; roda só o reviewer holístico; imprime parecer com badges no chat; não posta, não aplica, não grava no vault (exceto `--save`). Para review formal que persiste e posta, use o verbo `review` da família.
Orquestrador `flux:probe` — investiga telemetria de produção (Sentry e Datadog) e devolve um dossiê quantificado: agrega os alvos em paralelo, testa a explicação corrente contra a física dos números, confronta o lado do cliente com o do servidor, cruza com o código real via specialists, e grava tudo no mesmo board que o `flux:issue` consome depois. Não cria issue, não posta, não muda estado na fonte. Global, resolve contexto via `flux-context.md`.
Orquestrador `flux:refine` — refinamento numa rodada (fast SDD): recebe ideia, thread ou bug e produz PRD, TRD e plano de slices embasados em código real, no mesmo board que o `flux:issue` consome depois. Mede o escopo antes de trabalhar e recusa o que não cabe, entregando o corte proposto em vez de um refinamento raso. Opcional: quem não precisa refinar vai direto ao `flux:issue`. Global, resolve contexto via `flux-context.md`.
Orquestrador `flux:reply` — acompanha um CASO de trabalho no Slack embasado no codebase; prospecção em paralelo por repo, rascunho no Slack + board vivo no vault; segue o caso quando ele muda de canal; nunca posta sozinho. Global, resolve contexto leve via flux-context.json (VAULT_ROOT, VAULT_CTX, NO_EMDASH). Prospector e answerer vêm do manifesto; sem eles, cai em general-purpose.
Orquestrador `flux:review` — revisão formal de PR ou doc; reviewer holístico + specialists do repo reconciliados conforme `review-agents.md`; badges textuais conforme `review-legend.md`; persiste no vault. Global, resolve contexto via `flux-context.md`. Para relance rápido e read-only, use o verbo `peek` da família.
Plugin manifests2
{
"name": "flux",
"version": "1.43.0",
"description": "A complete, harness-neutral work cycle for Git repositories: probe, refine, issue, build, peek, review, iterate, land, and reply, chain to link them, plus map and equip, which prepare the machine and the repository.",
"author": {
"name": "Gabriel Gripp",
"email": "[email protected]",
"url": "https://github.com/grippado"
},
"homepage": "https://github.com/grippado/flux",
"repository": "https://github.com/grippado/flux",
"license": "MIT",
"keywords": [
"code-review",
"pull-request",
"agents",
"workflow",
"orchestration",
"codex"
],
"skills": "./skills/",
"interface": {
"displayName": "Flux",
"shortDescription": "One workflow. Every harness.",
"longDescription": "Flux is a shared family of twelve workflows that carries work from production telemetry to refinement, issue, code, quick look, review, iteration, landing, and reply, plus chain, which runs a validated sequence of them, and map and equip, which sit outside the cycle: map surveys the installation on your machine and dispatches the repairs you accept, equip prepares a repository. Claude Code, Cursor, and Codex use the same skills, agents, and contracts through native harness adapters.",
"developerName": "Gabriel Gripp",
"category": "Developer Tools",
"capabilities": [
"Interactive",
"Read",
"Write",
"CodeReview",
"MultiAgent"
],
"websiteURL": "https://github.com/grippado/flux",
"privacyPolicyURL": "https://github.com/grippado/flux/blob/main/PRIVACY.md",
"termsOfServiceURL": "https://github.com/grippado/flux/blob/main/LICENSE",
"defaultPrompt": [
"Review this pull request with Flux.",
"Turn this idea into a well-grounded issue.",
"Iterate on this PR until its checks settle."
],
"brandColor": "#8B5CF6",
"composerIcon": "./assets/flux-logo.svg",
"logo": "./assets/flux-logo.svg",
"logoDark": "./assets/flux-logo-dark.svg"
}
}{
"name": "flux",
"description": "Ciclo de trabalho agêntico para qualquer repo Git: probe, refine, issue, build, peek, review, iterate, land e reply, o chain que os encadeia, mais o map e o equip, que preparam a máquina e o repo. Global e context-agnóstico, com o que é específico do seu time vindo de um manifesto, nunca hardcoded.",
"version": "1.43.0",
"author": {
"name": "Gabriel Gripp",
"email": "[email protected]"
},
"homepage": "https://github.com/grippado/flux",
"license": "MIT",
"keywords": [
"code-review",
"pull-request",
"agents",
"workflow",
"orchestration"
]
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[flux on Agent Plugins Marketplace](https://pluginsmp.com/plugins/flux)