Agent Plugins Marketplace
← All plugins

flux

v1.43.0

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.

CodexClaude Code12 Skills

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

Installs for the current user
codex plugin marketplace add grippado/flux
codex plugin marketplace upgrade flux
codex plugin add flux@flux

Paste 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/flux

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/flux/.

Plugin files

plugins/flux/
├── .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

buildskills/build/SKILL.md

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.

chainskills/chain/SKILL.md

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

equipskills/equip/SKILL.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`.

issueskills/issue/SKILL.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`.

iterateskills/iterate/SKILL.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`.

landskills/land/SKILL.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.

mapskills/map/SKILL.md

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.

peekskills/peek/SKILL.md

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.

probeskills/probe/SKILL.md

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

refineskills/refine/SKILL.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`.

replyskills/reply/SKILL.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.

reviewskills/review/SKILL.md

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

plugins/flux/.codex-plugin/plugin.json
{
  "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"
  }
}
plugins/flux/.claude-plugin/plugin.json
{
  "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"
  ]
}

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)