Skip to content

Repository files navigation

🌌 Codexia 🧬

A professional-grade Agentic Engineering Terminal. Optimized for autonomous memory, enterprise-level security, and declarative automations.

License: Apache 2.0 Node.js Security


🚀 O que é a Codexia?

O Codexia evoluiu de um simples cliente de chat para um Motor de Engenharia Autônomo. Ele é projetado para desenvolvedores que precisam de um agente capaz de gerenciar contexto técnico complexo em longas sessões, com segurança criptográfica e consciência de workspace.


✨ Funcionalidades Avançadas

  • 🧠 Memória Agêntica Autônoma: A IA atua como Curadora de Memória, criando tópicos técnicos (memory/) e atualizando o índice (MEMORY.md) com autorização humana. Toda essa pasta é protegida de versionamento (privada ao usuário).
  • 💤 AutoDream (Consolidação Assíncrona): O motor grava silenciosamente telemetria de sessão em sessions.jsonl e auto-sintetiza contextos em tópicos [AUTO:DREAM], aliviando o uso de tokens.
  • 🛡️ Hardening de Segurança: Tokens criptografados com AES-256-GCM e sandbox de arquivos que impede acesso fora do workspace por padrão.
  • 🧊 Context Collapse: Sistema de compressão inteligente que sumariza o histórico de curto prazo ao atingir 40 mensagens.
  • 📂 Introspecção de Workspace: Comandos integrados para ler arquivos (/read), buscar documentações web (/fetch) e persistir mudanças (/write).
  • Real-time Streaming: Respostas geradas token por token com suporte a modo multiline (/paste).

🛠️ Instalação

  1. Clone o repositório:

    git clone https://github.com/Benevalterjr/Codexia.git
    cd Codexia
  2. Instale as dependências:

    npm install
  3. Inicie o motor:

    node chat.js

💡 Comandos Essenciais

  • /new — Reseta estado do servidor local (clear context).
  • /read <path> — Lê arquivos ou pastas com validação de sandbox.
  • /fetch <url> — Extrai conteúdo textual de páginas web usando Playwright.
  • /write <path> — Escrita de arquivos sugerida pelo agente (Human-in-the-Loop).
  • /run <file>.yaml — Executa padrões declarativos via YAML.
  • /model <id> — Troca de modelo e persistência de preferência.
  • /tokens — Diagnóstico de autenticação criptografada.

📐 Arquitetura

O projeto utiliza Clean Architecture para gerenciar a complexidade de um agente autônomo:

  • Domain: Constantes globais e regras de validação.
  • Infrastructure: Gateways de API e Repositórios Criptografados.
  • Application: Casos de uso de Chat, Automação e Sumarização.
  • Interface: Roteamento desacoplado de comandos via CommandRouter.js.

Para detalhes técnicos profundos, consulte o spec.md e o COMMANDS.md.


⚖️ Licença

Distribuído sob a licença Apache 2.0. Veja LICENSE para mais informações.


Criado com 💎 pela Dyad Apps

Releases

Packages

Contributors

Languages