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.
Proveniência Assinada
Sessões Rastreadas
Viagem no Tempo Git
Sessões Reproduzíveis
Autocomplete de Aba no estilo IDE
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.
O Agensic foi projetado para integrar-se profundamente ao seu ambiente de shell.
macOS (Zsh) — totalmente suportado ✅
Linux (Bash) — totalmente suportado ✅
O caminho mais rápido é o instalador gerenciado de uma linha:
curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash
Se preferir clonar manualmente:
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:
agensic setup
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!
Comece a trabalhar, como faria normalmente, por exemplo usando seu assistente de codificação de IA favorito, como Claude Code, Codex CLI, etc:
claude
ou
codex
Consulte a seção Agentes Suportados para uma lista completa de todos os agentes suportados. Se o seu agente não estiver na lista, você pode adicioná-lo executando agensic --add_agent "executable" 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:
agensic sessions
ou visualizar a proveniência forense:
agensic provenance
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.
Precisa responder: "O que exatamente foi executado aqui e quem o acionou?" Execute agensic provenance 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.
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 AI_EXECUTED 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.
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.
O Agensic atualmente suporta os seguintes rótulos de proveniência:
AI_EXECUTED para comandos executados diretamente por um agente de IA com prova assinadaHUMAN_TYPED para comandos digitados manualmente por um humano no shellAI_SUGGESTED_HUMAN_RAN para comandos sugeridos por uma chamada externa de LLM de IA e depois executados por um humanoAG_SUGGESTED_HUMAN_RAN para comandos sugeridos pelo Agensic e depois executados por um humanoINVALID_PROOF para comandos que chegaram com metadados de prova que falharam na validaçãoUNKNOWN para comandos onde a evidência disponível é insuficiente para atribuir um rótulo de atribuição mais forteO 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.
Precisa auditar a sessão da noite passada para entender o que aconteceu? Execute agensic sessions 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.
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.
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.
O Agensic oferece suporte a um conjunto de agentes integrados pré-configurados que podem ser rastreados:
Agentes Personalizados: insira qualquer executável de agente na configuração do agensic e ele funcionará imediatamente, sem necessidade de configuração
O Agensic reinventa as sugestões do terminal. Autocomplete de Aba com reconhecimento de contexto, semântico e sempre rápido, no estilo IDE.
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 Tab. 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.
Humanos cometem erros, o Agensic os corrige. Se você digitar dokcer, o Agensic sugere instantaneamente Você quis dizer: docker. 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 docker records, obterá Você quis dizer: docker logs (desde que você tenha executado docker logs no passado)
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 Ctrl+Space para buscar manualmente uma sugestão inteligente do seu LLM local ou hospedado preferido.
Esqueça a sintaxe exata, apenas descreva o que deseja. Digite algo como: # como posso encontrar todos os arquivos maiores que 10MB nesta pasta?. 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, ## Como instalar o Node no macOS?. Quer entender um comando antes de executá-lo? Use: agensic --explain "seu comando aqui"
O Agensic respeita seu terminal. Ele deixa o Tab 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 rm -rf, mkfs ou dd) são estritamente bloqueados dos pools de sugestão, para que você nunca execute um desastre acidentalmente.
O Agensic se encaixa em sua pilha, seja você executando modelos localmente ou usando endpoints hospedados.
A tabela abaixo lista todos os comandos CLI atualmente disponíveis no Agensic.
O Agensic opera com base no princípio do menor privilégio e máxima privacidade:
Alessio Leodori
Achou o Agensic útil? Dê uma estrela ⭐️ no repositório e conte para um amigo! Isso nos ajudará a crescer 🌱
O Agensic é open-source e licenciado sob a Licença Apache-2.0.
| Comando | O que faz |
|---|
agensic --help | Mostra a ajuda principal da CLI e todos os comandos padrão voltados ao usuário |
agensic --version | Exibe a versão instalada do Agensic e sai |
agensic update | Baixa e instala a versão mais recente publicada do Agensic no GitHub |
agensic setup | Abre o fluxo de configuração interativa para Sessões e Autocomplete do Agensic |
agensic enable-startup | Configura o Agensic para iniciar automaticamente ao fazer login ou ligar |
agensic first-run | Executa o fluxo de integração da primeira instalação |
agensic start | Inicia o daemon em segundo plano do Agensic manualmente |
agensic stop | Para o daemon do Agensic |
agensic logs | Monitora a saída do log do daemon em tempo real |
agensic test | Envia uma solicitação de autocomplete de teste para o daemon para verificar a conectividade |
agensic provenance | Abre a visualização do histórico de proveniência de comandos. Suporta filtros como --limit, --label e --contains |
agensic sessions | Abre o navegador de sessões rastreadas. Use --text para saída em texto simples |