ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add VilelaAI/kairos-forge
/plugin install kairos-forge@kairos-forge
Open the repo

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

The Quadro vivo section of the author's plugin README, in Portuguese: what the board shows (requirements by column, the SPEC's progress, the arc with its budget tokens, the three gates' verdicts, the task board's mobilizations), the two rules of the script, and that in Claude Code the same board sits beside the chat, /forge-painel opens it, the band above the prompt calls you when a gate waits, and the mod only reads.
Screenshot of the author's GitHub page.

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 || true
  • UserPromptSubmit · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" prompt 2>/dev/null || true
  • PreToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" comando
  • PreToolUse · Write|Edit|NotebookEditpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" escrita
  • PreToolUse · Readpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" leitura
  • PostToolUse · Write|Edit|Bashpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" ferramenta 2>/dev/null || true
  • PostToolUse · Bash|Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" alerta 2>/dev/null || true
  • PostToolUse · Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" spec
  • PostToolUse · Write|Editpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/guardrail.py" contrato
  • PostToolUse · 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.'; fi
  • Stop · *python3 "${CLAUDE_PLUGIN_ROOT}/scripts/execucao.py" fim 2>/dev/null || true
  • Stop · *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
Repo
VilelaAI/KairOS-Forge
Folder
plugin
Version
0.50.5
Repo stars
5
Last change
2026-11-06
Language
Python
Files
624

Other mods in Workflow

altimate-codeAltimateAIDraws a band for GitHub, Jira and Linear credentials it finds, an /integrations pane, and a /lineage pane of the dbt model Claude reads or edits.xcrewbreferrariHolds a commandDraws a live line above the prompt for each Xcode build and test, gives Claude only the failures, and asks you before Claude rewrites a generated project file.commit-medev-build-deployHolds a commandDenies a git commit whose message is not a Conventional Commit, with commit-me's error text and the allowed types and scopes, so Claude rewrites it.noctia-modsEtienneP-26Draws a Noctia band above the prompt, a side panel of subagents, an agent graph, a task checklist, and toasts when a Noctia guard blocks or questions a command.sidecarkaameo-labDocks a pane beside the chat with Claude's options and questions as buttons, a session summary, a diagram of the files it changed, and a log of each turn.android-device-consoleNathanWAHolds a commandDraws a band of live Android device toggles above the prompt and a /device pane for Doze, standby, and WorkManager jobs, and tells Claude the device state.android-logcatNathanWABounds Claude's adb logcat calls, redacts secrets from adb output, and keeps a pid-scoped logcat buffer for a logcat_grep tool and a /logcat pane.android-project-lensNathanWAHolds a commandAsks before Claude adds a permission that needs a Play Console declaration, gives it the real manifest SDKs and permissions, and adds a nav_graph route index.build-output-distillerNathanWASwaps Gradle console output for a short digest of errors and test failures with file:line lists and fix hints, flags a repeat failure, and opens a /build pane.plan-metervumichienDraws a one-line band above the prompt with how far your plan file is, in phases and steps, and how many of Claude's own tasks are done.idea-shelfvumichienParks an idea with /idea while Claude works, counts the shelf in a band, and sends nothing to the model until you press Send.session-monitorvumichienDraws a band of your other Claude Code sessions, how many wait on you, work, or are done, with their own line for sessions in this folder.
All 396 in Workflow