alex188dot/agensicForense de terminal criptográfica e reprodução de sessão para agentes de IA. Rastreia, assina e audita cada comando com rótulos de proveniência, sessões reproduzíveis e viagem no tempo Git. Prioriza a privacidade com armazenamento local SQLite e redação de segredos.
<p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/4480e118bb0f8f08f64f7da7573729d0dc6641679e7781e4c4050d939ea4d1b2.png" alt="Logotipo do Agensic" width="100%" /> </p> <h2 align="center">Saiba o que foi executado, onde, quando e por quem</h2> <h3 align="center">A camada de observabilidade que faltava para fluxos de trabalho de terminal com IA</h3> <p align="center"> <code>Proveniência Assinada</code> <code>Sessões Rastreadas</code> <code>Viagem no Tempo Git</code> <code>Sessões Reproduzíveis</code> <code>Autocomplete de Aba no estilo IDE</code> </p> --- O Agensic atualiza seu fluxo de trabalho de terminal existente para a era da IA. Ele foi construído para desenvolvedores que desejam o aumento de produtividade dos agentes de IA diretamente em seu shell, mas se recusam a comprometer **auditabilidade, controle e privacidade**. À medida que os agentes de IA assumem cada vez mais a linha de comando e executam tarefas de forma autônoma, visibilidade e controle se tornam críticos. O Agensic trata **comandos de terminal como cidadãos de primeira classe** e fornece uma estrutura robusta para rastrear, inspecionar e gerenciá-los. Em vez de achatar toda a atividade do terminal em um único "histórico de shell" ambíguo, o Agensic atua como um observador forense e um co-piloto inteligente. Ele rastreia perfeitamente sessões interativas de codificação com IA, assina criptograficamente comandos executados por agentes e fornece um autocomplete de Aba no estilo IDE, extremamente rápido e baseado no histórico. --- ## 📋 Índice 1. [Suporte a Plataformas](#-platform-support) 2. [Instalação](#-installation) 3. [Início Rápido](#-quick-start) 4. [Proveniência do Agensic](#-agensic-provenance) - [Recursos](#-features-provenance) - [Rótulos Suportados](#-supported-labels) 5. [Sessões do Agensic](#-agensic-sessions) - [Recursos](#-features-sessions) - [Agentes Suportados](#-supported-agents) 6. [Autocomplete do Agensic](#-agensic-autocomplete) - [Recursos](#-features-autocomplete) - [Provedores Suportados](#-supported-providers) 7. [Comandos Disponíveis](#-available-commands) 8. [Segurança e Privacidade](#-safety--privacy) 9. [Criador do Projeto](#-project-creator) 10. [Suporte](#-support) 11. [Licença](#-license) --- ## 💻 <a id="-platform-support"></a>Suporte a Plataformas O Agensic foi projetado para integrar-se profundamente ao seu ambiente de shell. - macOS (Zsh) — totalmente suportado ✅ - Linux (Bash) — totalmente suportado ✅ --- ## 🚀 <a id="-installation"></a>Instalação O caminho mais rápido é o instalador gerenciado de uma linha: ```bash curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash ``` Se preferir clonar manualmente: ```bash git clone https://github.com/Alex188dot/agensic.git cd agensic bash ./install.sh ``` Se você já tem o `uv`, o instalador o usará automaticamente para uma configuração mais rápida. Na primeira execução, o Agensic solicitará que você escolha seu provedor de LLM preferido e configure suas chaves de API para o autocomplete de comandos. Alternativamente, você pode configurar seu provedor de LLM e chaves de API executando: ```bash agensic setup ``` ## ⚡ <a id="-quick-start"></a>Início Rápido Após a configuração, **abra um novo terminal** e o Agensic começará automaticamente a rastrear sua atividade no terminal e fornecer sugestões de autocomplete enquanto você digita! ### 🤖 Rastreamento Automático de Agentes Sem Costura Comece a trabalhar, como faria normalmente, por exemplo usando seu assistente de codificação de IA favorito, como Claude Code, Codex CLI, etc: ```bash claude ``` ou ```bash codex ``` Consulte a seção [Agentes Suportados](#-supported-agents) para uma lista completa de todos os agentes suportados. Se o seu agente não estiver na lista, você pode adicioná-lo executando <code>agensic --add_agent "executable"</code> e então usá-lo normalmente para que o Agensic possa rastreá-lo. Depois de terminar, você pode usar o Agensic para inspecionar o histórico da sessão: ```bash agensic sessions ``` ou visualizar a proveniência forense: ```bash agensic provenance ``` --- ## 🧾 <a id="-agensic-provenance"></a>Proveniência do Agensic O Agensic fornece um transcript forense para cada comando. Ele classifica o que aconteceu, registra metadados ricos e exibe uma trilha de auditoria clara para que você possa saber se um comando foi digitado manualmente, aceito de uma sugestão ou executado diretamente por um agente. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/954db235102e042437af9e18befe1d48176d543e55a5bd8ba5cc3ff7a8396f41.gif" alt="Demonstração de proveniência do Agensic" width="75%" /> </p> ### <a id="-features-provenance"></a>✨ Recursos ### 🔍 Explorador de Proveniência em Tela Cheia <p> Precisa responder: "O que exatamente foi executado aqui e quem o acionou?" Execute <code>agensic provenance</code> para abrir o visualizador de proveniência em tela cheia. Filtre por rótulo, agente, provedor ou janela de tempo, inspecione a trilha exata do comando e exporte a visualização atual para JSON ou CSV quando precisar de um registro durável para depuração, revisão de incidentes ou conformidade. </p> ### 🛡️ Proveniência e Assinatura Criptográfica de Comandos <p> Pare de adivinhar se um humano ou uma IA quebrou a build. O Agensic captura metadados ricos para cada comando e usa assinatura local Ed25519 para marcar execuções de agentes com um rótulo <code>AI_EXECUTED</code> inegável. Você obtém uma linha do tempo clara e auditável separando as teclas humanas das sugestões de IA e execuções automatizadas. </p> ### 🏷️ Rótulos de Atribuição Estruturados <p> O Agensic não reduz o histórico do terminal a uma lista bruta de strings. Cada comando rastreado é classificado em um rótulo de proveniência, fornecendo uma maneira consistente de filtrar execuções, investigar comportamento e entender como um comando entrou no seu shell em primeiro lugar. </p> ### <a id="-supported-labels"></a>🔖 Rótulos Suportados O Agensic atualmente suporta os seguintes rótulos de proveniência: - <code>AI_EXECUTED</code> para comandos executados diretamente por um agente de IA com prova assinada - <code>HUMAN_TYPED</code> para comandos digitados manualmente por um humano no shell - <code>AI_SUGGESTED_HUMAN_RAN</code> para comandos sugeridos por uma chamada externa de LLM de IA e depois executados por um humano - <code>AG_SUGGESTED_HUMAN_RAN</code> para comandos sugeridos pelo Agensic e depois executados por um humano - <code>INVALID_PROOF</code> para comandos que chegaram com metadados de prova que falharam na validação - <code>UNKNOWN</code> para comandos onde a evidência disponível é insuficiente para atribuir um rótulo de atribuição mais forte --- ## 🕵️♂️ <a id="-agensic-sessions"></a>Sessões do Agensic O Agensic grava sessões interativas de agentes, fornecendo prova inegável do que aconteceu e a capacidade de manipular com segurança o estado do repositório, através do recurso de Viagem no Tempo. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/5a2de01b27f96092f2a728dcd93c9368336747306cea978c81b18ad3b6714f5e.gif" alt="Demonstração de reprodução do Agensic" width="75%" /> </p> ### <a id="-features-sessions"></a>✨ Recursos ### ▶️ Sessões Reproduzíveis <p> Precisa auditar a sessão da noite passada para entender o que aconteceu? Execute <code>agensic sessions</code> e selecione a sessão que deseja reproduzir. Nossa TUI em tela cheia extremamente rápida permite que você navegue instantaneamente pelas linhas do tempo, inspecione os payloads e reproduza a sessão. Quando precisar compartilhar evidências para uma revisão de incidente, exporte o conjunto de dados exato para JSON ou CSV com um único toque. </p> ### ⏪ Viagem no Tempo <p> Já se perguntou: "Como estava meu repositório exatamente antes do agente fazer aquele commit destrutivo?" A Viagem no Tempo permite que você rebobine seu repositório para o estado exato do Git capturado em um checkpoint específico da sessão. O Agensic restaura com segurança arquivos não rastreados e modificados em um novo branch, garantindo que você nunca destrua acidentalmente sua árvore de trabalho ativa durante a investigação. </p> ### 🗄️ Estado Local-Primeiro Resiliente <p> Seus dados permanecem seus. O Agensic usa um backend de estado SQLite robusto com um diário de eventos somente anexação e snapshotting automatizado. Isso significa que seu histórico forense sobrevive a falhas inesperadas do terminal, reinicializações do sistema e uso local de longo prazo sem corrupção. </p> ### <a id="-supported-agents"></a>🤖 Agentes Suportados O Agensic oferece suporte a um conjunto de agentes integrados pré-configurados que podem ser rastreados: - Claude Code - Codex CLI - Gemini CLI - OpenClaw - OpenCode - Kimi Code - Mini Agent - Qwen Code - GitHub Copilot CLI - Kiro CLI - Cline CLI - Cursor CLI - Nanoclaw - Droid - Hermes Agent - Ollama - Mistral Vibe - Aider - Pi.dev - Kilo Code - Continue CLI Agentes Personalizados: insira qualquer executável de agente na configuração do agensic e ele funcionará imediatamente, sem necessidade de configuração --- ## ⚡ <a id="-agensic-autocomplete"></a>Autocomplete do Agensic O Agensic reinventa as sugestões do terminal. Autocomplete de Aba com reconhecimento de contexto, semântico e sempre rápido, no estilo IDE. <p align="center"> <img src="https://assets.kitploit.com/production/public/readmes/12868/f710d6a7c01b14691b1d825894e1640c2a92ff1642178a5aed2b3d7d0ac241e3.gif" alt="Demonstração de autocomplete do Agensic" width="50%" /> </p> ### <a id="-features-autocomplete"></a>✨ Recursos ### 🚀 Sugestões de Histórico Local Extremamente Rápidas <p> Diga adeus à latência de entrada. Enquanto você digita, o Agensic consulta um armazenamento do seu histórico real de comandos. As sugestões aparecem instantaneamente como texto fantasma, que você pode aceitar facilmente com <code>Tab</code>. Como ele aprende com seus padrões e depende do que você realmente faz, as sugestões são altamente precisas e conscientes do repositório. </p> ### 🧠 Pesquisa Semântica e Recuperação de Erros de Digitação <p> Humanos cometem erros, o Agensic os corrige. Se você digitar <code>dokcer</code>, o Agensic sugere instantaneamente <code>Você quis dizer: docker</code>. Não consegue lembrar da sintaxe exata? O reordenamento semântico resgata sua intenção, encontrando o comando certo mesmo que seu prefixo não corresponda perfeitamente: se você digitar <code>docker records</code>, obterá <code>Você quis dizer: docker logs</code> (desde que você tenha executado <code>docker logs</code> no passado) </p> ### 💡 Fallback de IA Sob Demanda <p> A IA é um fallback poderoso, não um imposto sobre cada tecla. O Agensic impõe orçamentos de LLM por linha para evitar spam de prompts. Quando o histórico local não é suficiente, o fallback automático de LLM será acionado. Alternativamente, você pode sempre pressionar <code>Ctrl+Space</code> para buscar manualmente uma sugestão inteligente do seu LLM local ou hospedado preferido. </p> ### 💬 Modos de Comando em Linguagem Natural <p> Esqueça a sintaxe exata, apenas descreva o que deseja. Digite algo como: <code># como posso encontrar todos os arquivos maiores que 10MB nesta pasta?</code>. O Agensic gera 3 comandos de shell prontos para copiar e insere a opção mais provável diretamente na sua próxima linha. Precisa de orientação em vez de comandos? Use o modo assistente para obter respostas passo a passo diretamente no seu terminal, <code>## Como instalar o Node no macOS?</code>. Quer entender um comando antes de executá-lo? Use: <code>agensic --explain "seu comando aqui"</code> </p> ### 🛡️ Preservação de Aba Nativa e Bloqueio de Riscos <p> O Agensic respeita seu terminal. Ele deixa o <code>Tab</code> em paz quando você está completando caminhos de arquivo ou scripts, para que a conclusão nativa do shell ainda vença onde é melhor. Mais importante, comandos destrutivos (como <code>rm -rf</code>, <code>mkfs</code> ou <code>dd</code>) são estritamente bloqueados dos pools de sugestão, para que você nunca execute um desastre acidentalmente. </p> ### <a id="-supported-providers"></a>🌐 Provedores Suportados O Agensic se encaixa em sua pilha, seja você executando modelos localmente ou usando endpoints hospedados. - **Local:** Ollama, LM Studio - **Hospedados:** OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker - **Personalizado:** qualquer endpoint compatível com OpenAI - **Apenas Histórico:** execute completamente offline sem chamadas de IA, usando apenas seu histórico de comandos local ## 🧰 <a id="-available-commands"></a>Comandos Disponíveis A tabela abaixo lista todos os comandos CLI atualmente disponíveis no Agensic. | Comando | O que faz | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | <code>agensic --help</code> | Mostra a ajuda principal da CLI e todos os comandos padrão voltados ao usuário | | <code>agensic --version</code> | Exibe a versão instalada do Agensic e sai | | <code>agensic update</code> | Baixa e instala a versão mais recente publicada do Agensic no GitHub | | <code>agensic setup</code> | Abre o fluxo de configuração interativa para Sessões e Autocomplete do Agensic | | <code>agensic enable-startup</code> | Configura o Agensic para iniciar automaticamente ao fazer login ou ligar | | <code>agensic first-run</code> | Executa o fluxo de integração da primeira instalação | | <code>agensic start</code> | Inicia o daemon em segundo plano do Agensic manualmente | | <code>agensic stop</code> | Para o daemon do Agensic | | <code>agensic logs</code> | Monitora a saída do log do daemon em tempo real | | <code>agensic test</code> | Envia uma solicitação de autocomplete de teste para o daemon para verificar a conectividade | | <code>agensic provenance</code> | Abre a visualização do histórico de proveniência de comandos. Suporta filtros como <code>--limit</code>, <code>--label</code> e <code>--contains</code> | | <code>agensic sessions</code> | Abre o navegador de sessões rastreadas. Use <code>--text</code> para saída em texto simples | ## 🔒 <a id="-safety--privacy"></a>Segurança e Privacidade O Agensic opera com base no princípio do menor privilégio e máxima privacidade: - **Autenticação Local:** toda rota de API no localhost é estritamente autenticada com rotação automática de tokens - **Redação de Segredos:** valores de alta entropia, credenciais de URL e formatos de segredo conhecidos (como chaves AWS ou JWTs) são removidos e redigidos **antes** que qualquer dado saia da sua máquina para uma chamada de LLM - **Diretrizes de Comandos:** comandos destrutivos são bloqueados tanto no mecanismo de sugestão quanto no loop de feedback - **Limitação de Taxa:** chamadas de LLM de saída são limitadas por timeouts e orçamentos estritos para evitar abuso de API --- ## <a id="-project-creator"></a>👤 Criador do Projeto Alessio Leodori ## <a id="-support"></a>🤝 Suporte Achou o Agensic útil? Dê uma estrela ⭐️ no repositório e conte para um amigo! Isso nos ajudará a crescer 🌱 ## 📄 <a id="-license"></a>Licença O Agensic é open-source e licenciado sob a **Licença Apache-2.0**.
