convez.ai
SkillAutomaçãoIntermediário
petekp

Circuit

petekp/circuit

Workflows repetíveis e estruturados para agentes de código

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que permite agentes de IA executar workflows repetíveis e multi-etapas, substituindo prompting manual e supervisionamento constante. Define fluxos de trabalho estruturados (build, fix, review, explore, prototype, pursue) com checagem automática de saídas e rastreamento de evidências.

Instalação

$npx convez-ai petekp/circuit

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
4
Contribuidores
2

Casos de uso

  • Automatizar processos de desenvolvimento com múltiplas etapas
  • Executar fluxos de review e validação de código em sequência
  • Substituir prompting ad-hoc por workflows determinísticos
  • Rastrear e documentar decisões e resultados de agentes

Veredito

Circuit é uma abstração valiosa para elevar agentes de código além de chat linear, introduzindo processos estruturados e verificação de qualidade. Ideal para times que usam Claude Code ou Codex e precisam de workflows robustos e auditáveis.

README

A tradução para o português deste README ainda está na fila.

Go from this:

  • Remember which chat thread has the latest state
  • Remember which skill to use and when
  • Ask for routine planning, checking, and review steps by hand
  • Wonder whether the agent took shortcuts or repeated an old mistake
  • Keep nudging the process forward yourself

To this:

  • /circuit:run build the thing

Circuit puts the process into a repeatable flow:

  • Records the chosen built-in, custom, or dynamically determined flow
  • Moves through each step in sequence and/or parallelizes non-dependent steps
  • Applies your preferred skills at the appropriate steps
  • Uses your preferred model(s) and thinking power for particular steps
  • Checks step outputs before continuing, including deterministic relay acceptance criteria where a flow declares them, with traces, reports, and evidence that show what passed

Ready to try it? Pick a host below, or point your coding agent at the setup prompt. For the full docs map, see docs/README.md.

Start Here

Pick the path that matches where you want to use Circuit. If you want a coding agent to set this up for you, skip to Give This To A Coding Agent.

Claude Code

Install the host plugin:

/plugin marketplace add petekp/circuit
/plugin install circuit@circuit
/reload-plugins

Then ask Circuit to handle a task:

/circuit:run the checkout total is wrong when discounts and tax both apply

The installed plugin is self-contained. You do not need to clone this repo, run npm install, install a circuit binary, or create a symlink.

Codex

Install the published plugin from the marketplace:

codex plugin marketplace add petekp/circuit --ref circuit--v0.1.0-alpha.7

Working from this checkout instead? Refresh the local plugin package and installed host caches:

npm run plugins:refresh-local

Then ask Codex to use Circuit:

/circuit:run the checkout total is wrong when discounts and tax both apply

Codex can recommend the right Circuit flow from your natural-language request.

Local CLI

From this checkout:

npm install
npm run build
./bin/circuit run <flow> --goal '<your task>'

The flow name is required: one of build, fix, review, explore, prototype, or pursue. Run the CLI from the checkout root; the operator guide covers running from another directory with --flow-root.

Circuit requires Node.js 22.18.0 or newer. For a more careful manual check, use docs/first-run.md. For the repo map, use docs/repository-map.md.

Start From An Intent

/circuit:run is the normal front door on every host. See docs/operator-guide.md for the per-host table, the CLI flow-name rule, and the host-alias status.

Handoff stays available as a visible continuity utility for saving, resuming, clearing, briefing, or installing continuity support. The CLI also has an experimental ./bin/circuit create utility for drafting reusable custom flows after explicit confirmation, but Create is not published as a host command. See docs/operator-guide.md for direct commands, flags, checkpoints, verification, and troubleshooting.

Safety Notes

Build, Fix, Prototype, and Pursue may invoke a write-capable worker. Circuit discloses that before write-capable work starts:

A worker can edit this checkout.

Review collects untracked file paths and sizes by default, but not untracked file contents. Add --include-untracked-content only after you confirm those files are safe to relay.

Built-in worker connectors are claude-code, codex, and cursor-agent. Use claude-code for trusted Claude Code writes, codex for first-class Codex worker writes, and cursor-agent for Cursor CLI implementer work.

Custom connectors use the prompt-file/output-file protocol. stdin is ignored, the process inherits the Circuit process environment and current working directory, and capabilities.filesystem: read-only is a routing signal, not an OS sandbox.

Host And Worker Terms

Codex has two separate roles:

  • host/orchestrator behavior: in Codex, use /circuit:run for a task. Codex can recommend the right Circuit flow and invoke the local Circuit engine.
  • worker connector behavior: Circuit can relay worker steps through the Codex CLI from any host, including write-capable implementer steps.

See docs/configuration.md for connector routing and worker setup.

Configuration

Circuit reads config at run time from:

  1. ~/.config/circuit/config.yaml for your personal defaults across projects.
  2. ./.circuit/config.yaml at the repo root for project-specific overrides.

Config can set models, effort, local skills, connector routing, and per-flow overrides. See docs/configuration.md.

Give This To A Coding Agent

Paste this into a coding agent when you want it to set up Circuit from a checkout safely:

You are setting up Circuit in this repo: <repo-path>.

Stay inside that checkout. Read README.md and docs/agent-setup.md, then follow
the setup checklist there. Do not hand-edit generated host output. Preview any
config YAML before writing it. Use Review as the first real run unless I ask
for a write-capable flow. Report commands run, files changed, verification
results, and any blocker.

See docs/agent-setup.md for the full setup checklist.

Where To Go Next

Start:

Operate:

Contribute or verify:

License

Circuit is released under the MIT License. You are free to use, modify, and redistribute it, including commercially, as long as you keep the copyright and license notice.

Ver o original no GitHub

Bom para

Relacionados