All shelves / Mods / Workflow
kairos-forge
By VilelaAI
kairos-forge is a Claude Code workflow mod by VilelaAI.
Draws a panel of the delivery arc and a band when a human gate waits, asks before a call a revert cannot undo, and masks secrets in tool output.
DrawsHolds a command
Install
The marketplace name is kairos-forge.
/plugin marketplace add VilelaAI/kairos-forge /plugin install kairos-forge@kairos-forge
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.50.5
- Repo stars
- 5
- Last change
- 2026-11-06
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
- Calls another program on this machine
Run /reload-plugins after installing. The panel, the pause and the secret masking exist only in Claude Code, as mods; the same plugin also runs in Codex CLI, OpenCode and Cursor. /kairos-forge:mobilizar, the parallel team, needs export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. The hooks, guardrails, telemetry and panel scripts are Python 3 scripts that use only the standard library. The README is in Portuguese. The guardrail floor (sacred paths, secret reads, the hooks wiring and four command rules) cannot be configured; the other classes take a block or warn mode per class in .agents/guardrails.json.
The marketplace, kairos-forge, holds only this plugin; the repository root is both the source and the marketplace, and the install uses its plugin folder. The plugin is a software factory of 71 agents and 19 skills, and this page covers its mods for Claude Code. The delivery arc, with the gates that wait for you, is why this page files it under workflow. interlock-renzrollon, for spec-driven development on OpenSpec, draws each wave and lane of a ship run, and refuses a test edit during the fix stage. console-status draws a pane and a band for several projects, and asks before a shell command that cannot be taken back. This one opens /forge-painel beside the conversation with the arc from specify to PR and the phase marked, shows a band above the prompt and a toast when a human gate waits, and answers /forge-caixa as text. It asks before a call a revert cannot undo, such as terraform apply, a deploy, npm publish, a push to main, a remote database migration, or a merge through MCP. A token, password or key in the output of a command or an MCP tool becomes a mark before the model reads it. The guardrail scripts also block destructive commands and secret reads by code.
Demo

Hooks 13
SessionStart · *echo '🔥 kairos-forge v0.50 ativo — 71 agentes (40 core + 31 apoio em 10 squads) | 19 skills: /kairos-forge:onboardar mapear-arquitetura diagnosticar especificar analisar-ameacas desenhar mobilizar rodar validar revisar entregar avaliar lancar mapear-conhecimento otimizar migrar auditar evoluir relatar | Para mobilizar paralelo: export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1'SessionStart · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" inicio 2>/dev/null || trueUserPromptSubmit · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" prompt 2>/dev/null || truePreToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" comandoPreToolUse · Write|Edit|NotebookEditpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" escritaPreToolUse · Readpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" leituraPostToolUse · Write|Edit|Bashpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" ferramenta 2>/dev/null || truePostToolUse · Bash|Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" alerta 2>/dev/null || truePostToolUse · Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" specPostToolUse · Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" contratoPostToolUse · Write|EditIN=$(cat); FILE=$(printf '%s' "$IN" | jq -r '.tool_input.file_path // empty'); SID=$(printf '%s' "$IN" | jq -r '.session_id // "sem-sessao"'); MARCA="${TMPDIR:-/tmp}/kairos-forge-lembrete-$SID"; if [ ! -e "$MARCA" ] && printf '%s' "$FILE" | grep -qE '\.(py|ts|tsx|js|jsx|go|rs|java)$' && ! printf '%s' "$FILE" | grep -qE '(test|spec|__tests__)'; then touch "$MARCA"; echo '💡 kairos-forge: primeiro arquivo de produção desta sessão. A Definition of Done cobre teste (Ricardo), /kairos-forge:validar se houver SPEC e /kairos-forge:revisar antes do PR — este aviso não se repete na sessão.'; fiStop · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" fim 2>/dev/null || trueStop · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" parada
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- VilelaAI
- Category
- Workflow
- Marketplace
- kairos-forge
- Folder
- plugin
- Version
- 0.50.5
- Repo stars
- 5
- Last change
- 2026-11-06
- Language
- Python
- Files
- 624