O Pi lhe dá controle excepcionalmente fino sobre roteamento de provedor, modo de pensamento, reutilização de sessão e exposição de ferramentas, mas um fluxo de trabalho puramente de terminal ainda deixa gestão de projeto, orquestração e persistência de conhecimento de longo prazo para o usuário.
No trabalho de entrega real, essas camadas que faltam importam mais do que um único comando inteligente. O HagiCode fornece a estrutura de fluxo de trabalho que o Pi mesmo não tenta possuir.
Multithreading: deixar o Pi rodar múltiplas pistas de codificação controladas de uma vez
O Pi pode fazer muito dentro de uma sessão, mas a entrega real raramente acontece uma tarefa por vez.
O HagiCode permite que você rode múltiplas sessões Pi em paralelo, cada uma com contexto isolado, uma fronteira de responsabilidade clara e progresso independente.
Isso transforma o Pi de uma CLI configurável de thread única em um workbench de engenharia paralela que corresponde a como as equipes realmente constroem software.
- A Thread A refina os endpoints da API backend;
- A Thread B refatora componentes frontend;
- A Thread C escreve testes unitários;
- A Thread D audita o código em busca de vulnerabilidades de segurança.
Sessões de proposta OpenSpec: vincular as escolhas de provedor e modelo do Pi a decisões rastreáveis
No desenvolvimento diário, o caos mais comum não é a incapacidade de escrever código — é fazer um monte de mudanças e depois esquecer por que você as fez, o que você mudou e como essas mudanças se relacionam entre si.
O fluxo de trabalho de proposta OpenSpec integrado no HagiCode resolve fundamentalmente esse problema. Cada tarefa de desenvolvimento inicia como uma proposta:
Essa abordagem de 'pensar primeiro e depois agir' dá ao modelo de roteamento flexível do Pi um lugar para ser documentado. Meses depois, você ainda pode ver não apenas o que mudou, mas por que um certo provedor, rota de modelo ou fronteira de ferramenta foi escolhido.
- Primeiro, anote qual problema esta tarefa resolve e por que esta abordagem faz sentido;
- Discuta a abordagem técnica em profundidade com Pi dentro do framework da proposta — todas as conversas e decisões são registradas no contexto da proposta;
- Uma vez confirmada a abordagem, Pi implementa o código dentro das restrições da proposta;
- O documento de proposta final, os registros de discussão e as mudanças de código formam uma cadeia de rastreabilidade completa.
Commits de IA: transformar a saída do Pi em um histórico de commit limpo
Escrever mensagens de commit depois de terminar o código é uma forma de fricção mental para muitos desenvolvedores. Muito casual e você não consegue encontrar commits-chave depois; muito formal e parece tempo desperdiçado.
O recurso de commit de IA do HagiCode confia isso inteiramente ao Pi: ele analisa suas mudanças de código, entende a intenção e o escopo de impacto, depois gera automaticamente mensagens de commit claramente estruturadas, semanticamente precisas. Mais importante, durante o commit de IA, o HagiCode bloqueia automaticamente o repositório para evitar conflitos de estado de operações concorrentes, garantindo commits seguros e confiáveis.
Economize sua atenção para a criação — deixe Pi cuidar da papelada do commit.
Editor de navegador Code Server: saltar da análise do Pi diretamente para a edição
Depois que Pi analisa o código, identifica o arquivo problemático e localiza o número exato da linha, o momento desconfortável familiar ocorre: você precisa sair da janela de conversa de IA, voltar ao seu IDE, encontrar o arquivo novamente e saltar manualmente para a posição certa. Essa quebra de contexto da análise para a edição não apenas interrompe seu fluxo mas mantém o valor da IA em 'dizer a você onde está o problema' em vez de 'ajudar você a entrar diretamente no modo de edição'.
O editor de navegador baseado em Code Server integrado no HagiCode é projetado especificamente para resolver essa quebra:
A integração do Code Server faz do HagiCode não apenas uma página frontend que pode analisar código, mas uma workstation completa onde a análise do Pi pode aterrissar diretamente como ações de edição. Isso minimiza o custo de troca de ferramenta entre a análise de IA e a modificação hands-on.
- Um clique da análise para a edição: assim que o Pi identifica em uma proposta o arquivo que precisa de mudanças, o HagiCode pode abrir diretamente aquele arquivo no workbench para edição. Você não precisa trocar de ferramentas nem relocalizar o arquivo.
- Local, contêiner, remoto — cobertura total: quer seu projeto rode em uma máquina local, em um contêiner Docker ou em um servidor remoto, o Code Server do HagiCode pode abrir o diretório do projeto através do navegador para edição.
- Edição direta do Vault: bibliotecas de referência de código e projetos de aprendizado registrados no seu Vault também podem ser abertos e navegados diretamente através do Code Server quando o Pi lhe aponta exemplos relevantes.
HagiTask: empacotar os fluxos de trabalho do Pi como plantas de comando reutilizáveis
A flexibilidade do Pi é poderosa, mas repetir as mesmas escolhas de provedor, fronteiras de ferramenta e enquadramento de tarefa repetidas vezes é wasteful.
O mecanismo HagiTask do HagiCode transforma esses padrões repetidos em templates reutilizáveis. É mais do que comandos de atalho — é uma plataforma de integração de Skills extensível:
O HagiTask eleva sua colaboração com o Pi de 'reconstruir o fluxo de trabalho toda vez' para 'escolher o fluxo de trabalho preparado e rodá-lo'. É aí que a configurabilidade se torna alavancagem operacional real.
- Skills de comunidade prontas para usar: importe fluxos de trabalho provados de revisão, refactor, CRUD e documentação em vez de reconstruí-los do zero toda vez.
- Sistema de Skills extensível: adapte os templates compartilhados às suas próprias convenções de equipe, padrões de roteamento e padrões de codificação.
- Operações visuais, não contabilidade de terminal: escolha tarefas, troque parâmetros e reordene a execução em uma interface dedicada em vez de codificar tudo em hábitos CLI repetidos.
Interface gamificada: tornar os botões de provedor do Pi visíveis e acessíveis
A programação em si pode ser tediosa, mas também pode ser divertida. O design de interface gamificado do HagiCode rompe com a experiência fria de ferramentas de linha de comando:
O Pi fornece controle, o HagiCode fornece experiência — juntos, eles transformam uma CLI altamente configurável em um workspace que as pessoas podem realmente gostar de operar diariamente.
- Feedback visual claro: o estado da sessão, o progresso e os resultados são visíveis sem cavar pela saída do terminal.
- Visualização de conquistas e progresso: commits, marcos de proposta e pontos de checagem de entrega se tornam marcadores de ritmo visíveis em vez de estado de fundo invisível.
- Menos fricção operacional: desenvolvedores que não são puristas de terminal também podem se beneficiar do modelo de controle do Pi através de uma camada de interface muito mais amigável.
Gestão de Agents: transformar múltiplas sessões do Pi em uma frota de Agents gerenciável
Sessões paralelas são úteis, mas uma vez que você tem várias rodando, a coordenação se torna o próximo gargalo.
A camada de gestão de Agents do HagiCode transforma cada worker Pi em um Agente nomeado, agendável, com status visível, escopo atribuído e configuração independente.
Você se move de 'muitos terminais estão abertos' para 'uma pequena equipe de IA está sendo coordenada em um só lugar'.
- Visualização de identidade e status do Agente: veja num relance qual Agente está rodando, esperando, bloqueado ou pronto para arquivar.
- Vinculação tarefa-para-Agente: propostas, revisões, refatorações e trabalho de teste podem ser atribuídos cada um a um Agente dedicado.
- Configuração de Agente independente: diferentes Agentes podem usar diferentes rotas de modelo, Skills, regras de exposição de ferramenta e escopos de contexto sem interferir entre si.
Gestão multi-repo Monospecs: dar ao Pi o mapa de repositórios que ele precisa
Em projetos reais, o código raramente vive em um único repositório. Frontend, backend, documentação, bibliotecas compartilhadas estão espalhadas por diferentes repos, e uma única mudança de funcionalidade pode precisar tocar vários repos simultaneamente. Para Pi, o modo mono-repo funciona, mas ele não tem compreensão nativa de relações cross-repo — você tem que dizer a ele manualmente em cada conversa que 'esta mudança também precisa sincronizar para outros dois repos', o que é claramente ineficiente.
O mecanismo Monospecs do HagiCode é a solução estruturada projetada para cenários multi-repo. Através do arquivo de configuração .hagicode/monospecs.yaml, ele declara todos os endereços, nomes e relações de sub-repos no grupo de projetos, dando ao Pi um mapa cross-repo automático ao lançar propostas:
O Monospecs essencialmente elimina os pontos cegos cognitivos do Pi na colaboração cross-repo. A flexibilidade de roteamento do Pi importa mais uma vez que ele também pode ver a superfície de mudança completa.
- Consciência automática de relações de repositório: ao criar uma proposta de desenvolvimento, o Pi pode ler diretamente a lista de sub-repos da configuração do Monospecs em vez de depender de explicação manual repetida.
- Rastreamento de mudanças cross-repo: as specs se mantêm centralizadas enquanto as mudanças de código ficam nos repositórios relevantes, mantendo o histórico de decisão e a implementação limpidamente separados.
- Direcionamento inteligente de repositório em commits de IA: o HagiCode analisa suas mudanças contra a configuração do Monospecs e sugere onde cada commit pertence.
- AGENTS.md por repositório: o Pi pega automaticamente convenções específicas de repositório ao operar através de diferentes codebases.
Base de conhecimento cross-projeto Vault: fazer o Pi lembrar de mais do que um turno de terminal
Os controles de sessão do Pi são úteis, mas mesmo sessões persistentes não são o mesmo que uma camada de memória cross-projeto durável. Sem isso, contexto importante ainda tem que ser reintroduzido com muita frequência.
O Vault é a camada de armazenamento de conhecimento persistente cross-projeto do HagiCode. Sua filosofia de design central é 'registre uma vez, reutilize em todo lugar':
Se o Monospecs permite que o Pi entenda onde os projetos estão, o Vault permite que o Pi lembre do que você já acumulou. Isso transforma uma CLI configurável em um parceiro de engenharia de mais longo prazo.
- Contêineres de conhecimento multi-tipo: registre pastas, projetos de referência de código, notas do Obsidian e ativos de prompt gerenciados pelo sistema em um só lugar.
- Injeção automática de contexto de IA: novas propostas começam com o material de referência correto já disponível para o Pi.
- Controle de acesso granular fino: separe referências somente leitura de espaços de projeto editáveis para que o Pi possa aprender amplamente sem modificar a coisa errada.
- Reutilização de conhecimento cross-projeto: padrões capturados uma vez podem suportar cada proposta posterior em vez de serem reconstruídos do zero.
Roteamento de modelo OmniRoute: tornar o design provedor-primeiro do Pi utilizável em escala
Equipes deveriam poder manter o fluxo de trabalho que gostam sem bloquear o acesso ao modelo a um fornecedor ou um caminho de assinatura.
O OmniRoute separa a camada de interação da camada de roteamento de modelo, de modo que o HagiCode pode manter Pi no fluxo de trabalho enquanto troca as fontes de modelo por baixo.
Isso lhe dá melhor controle de custo, melhor encaixe tarefa-para-modelo e menos agitação de fluxo de trabalho quando o preço ou a disponibilidade do modelo mudam.
- Mantenha a CLI ou o estilo de interação que você já prefere enquanto muda apenas a rota de modelo por baixo.
- Compartilhe uma estratégia de roteamento entre múltiplos Agentes e múltiplas ferramentas de IA conectadas ao HagiCode.
- Ajuste diferentes rotas de modelo para diferentes cargas de trabalho, como codificação rápida, revisão profunda ou planejamento de arquitetura.
- Ajuste custo e capacidade uma vez na camada de roteamento em vez de retrabalhar cada fluxo de trabalho individual.
Visão unificada de chamadas de ferramenta: veja o uso de ferramentas de Pi em um formato consistente
O HagiCode anexa um único formato tipado de chamada de ferramenta a cada mensagem de uso e de resultado de ferramenta. Ele registra o tipo da ferramenta, seus campos de entrada, o status, o texto ou as imagens do resultado, qualquer erro e o tempo gasto. O formato é calculado a partir dos dados armazenados, então o histórico da sessão e as atualizações ao vivo mostram a mesma visão.
O mesmo formato vale para todos os provedores, então as chamadas de ferramenta de Pi ficam parecidas com as de qualquer outro agente do seu workspace. Você lê um único formato em vez de aprender a saída bruta de cada CLI.
- Um formato para todos os provedores: chamadas de shell, arquivos, busca, fetch e MCP são apresentadas de forma consistente;
- Chamadas com falha trazem uma mensagem de erro legível;
- Imagens raster de ferramentas são transportadas como data URI.
Uso num relance: tokens e custo de hoje na barra de status
O HagiCode pode exibir na barra de status os tokens consumidos e o custo de hoje, vindos do aplicativo desktop TokenMonitor. A integração é opcional e vem desativada por padrão.
Ela lê o arquivo de dados local do TokenMonitor ou um HostHub do TokenMonitor em intervalos regulares e guarda apenas o total de tokens e o custo de hoje. A barra de status continua sendo uma olhada rápida, não um relatório completo de uso.
- Nada é lido até você ativar a integração;
- O segredo do HostHub é somente de escrita e nunca é devolvido nem registrado em log depois de salvo;
- Um endereço de HostHub inválido é rejeitado ao salvar.
Perguntas interativas: deixe Pi perguntar e depois continuar a mesma execução
Quando Pi precisa de uma decisão, pode fazer uma pergunta estruturada durante a execução. O HagiCode mostra a pergunta na conversa, o status da sessão muda de em execução para aguardando resposta, e a sua resposta faz a mesma execução continuar.
Se a execução já terminou, por exemplo após uma reinicialização ou um timeout, a sua resposta é enviada como uma mensagem normal na mesma sessão, para que o trabalho possa seguir adiante.
- Perguntas feitas pela CLI ao mesmo tempo podem ser respondidas juntas em um único envio;
- Uma pergunta sem resposta em 30 minutos expira e ainda pode ser respondida por meio de uma mensagem de acompanhamento;
- Ativado por CLI na configuração de controle interativo, para que você decida onde os agentes podem perguntar.
