Stagent: Camada de operações de código aberto para o Claude Agent SDK com governança local e orquestração de fluxos de trabalho

O que o Stagent faz

Stagent é um espaço de trabalho de coordenação local-first e de código aberto que se posiciona sobre o Claude Agent SDK e a API Claude. Ele padroniza como você roteia, supervisiona e mede o trabalho dos agentes em ambos os ambientes de execução sem substituí-los. O problema central que ele resolve: você não deveria precisar de uma planilha para rastrear o que seus agentes de IA estão fazendo, quanto custam ou se têm permissão para executar comandos perigosos.

Principais recursos e arquitetura

O sistema inclui 15 superfícies de produto: painel inicial, quadro de execução, caixa de entrada, monitoramento, livro de custos, chat, scanner de ambiente e mais. Ele fornece 6 padrões de orquestração de fluxo de trabalho: sequência, fork/join paralelo, ponto de verificação, planejador-executor, loop autônomo e enxame multiagente. Há 52+ perfis de agentes reutilizáveis, incluindo personas especialistas como revisor de código, pesquisador, redator de documentos, gestor de patrimônio e planejador de viagens, empacotados como habilidades do Claude Code com políticas de ferramentas e instruções comportamentais.

A governança com intervenção humana inclui permissões de permitir uma vez, permitir sempre e negar. Cada solicitação de ferramenta é roteada por uma fila de notificações, com AskUserQuestion sempre solicitando, independentemente das permissões salvas. Os guardrails de orçamento fornecem limites de gastos diários/mensais que interrompem novas chamadas de provedor quando excedidos, com avisos em 80% e conclusão graciosa do trabalho já em execução.

O livro de custos entre ambientes de execução rastreia velocidade de tokens, concentração de modelos, participação do ambiente de execução e trilhas de auditoria por tarefa em Claude e Codex em uma única visualização. Execuções agendadas suportam prompts recorrentes ou únicos com seleção de perfil de agente, limites de disparo e janelas de expiração.

Implementação técnica

O produto inteiro foi construído usando Claude Code com Opus, desde o esquema do banco de dados até os componentes da interface. A arquitetura é local-first com zero dependências externas, usando SQLite no modo WAL com Drizzle ORM (16+ tabelas). Tudo roda na sua máquina sem nuvem ou telemetria.

O sistema de aprovação usa a tabela de notificações como uma fila de mensagens. Quando um agente solicita uma ferramenta perigosa, canUseTool consulta a tabela de notificações até que um humano responda, permitindo governança sem websockets ou filas externas.

Os padrões de fluxo de trabalho incluem loops autônomos que executam agentes iterativamente, onde cada iteração vê a saída anterior (inspirado no conceito de "laboratório de pesquisa com uma GPU" de Karpathy), enxames multiagentes usando um padrão Prefeito→Trabalhadores→Refinaria com concorrência limitada (2-5 trabalhadores) e nova tentativa no nível da etapa, e fork/join paralelo que divide questões de pesquisa entre ramos e sintetiza os resultados.

O catálogo de modelos significa que você nunca configura fluxos de trabalho manualmente. Você escolhe um modelo (revisão de código, pesquisa aprofundada, planejamento de sprint), preenche as variáveis, e o modelo resolve perfis, prompts e etapas condicionais automaticamente.

O scanner de ambiente descobre todos os seus artefatos do Claude Code e Codex CLI — habilidades, hooks, servidores MCP, permissões, arquivos de memória — e apresenta uma pontuação de saúde unificada, com varreduras típicas levando 10-50ms.

Stack tecnológica

Next.js 16, React 19, TypeScript, Tailwind v4, shadcn/ui, SQLite, Drizzle ORM, Claude Agent SDK, Codex App Server.