HysCode

IDE agentiva nativa para desktop — onde agentes de IA escrevem, editam e executam código usando ferramentas reais de desenvolvedor.

---

Índice

• O que é o HysCode?
• Destaques
• Arquitetura
• Stack Tecnológico
• Começando (rápido)
• Desenvolvimento
• Build/Produção
• Estrutura do Repositório
• Documentação
• Contribuição
• Segurança
• Licença

---

O que é o HysCode?

HysCode reimagina o fluxo de desenvolvimento trazendo agentes de IA para o coração do ambiente de desenvolvimento. Em vez de apenas sugerir código, agentes podem:

• Escrever e editar código em tempo real usando o Monaco Editor
• Executar ferramentas de desenvolvedor (terminal, git, operações de arquivo)
• Seguir especificações com o motor Spec-Driven Development (SDD)
• Solicitar aprovação do usuário para cada alteração — você sempre tem controle final

Destaques

• Agentes autônomos com ciclo de feedback (SDD)
• Integração com múltiplos provedores de IA (Anthropic, OpenAI, Gemini, Ollama, OpenRouter)
• Shell Rust/Tauri para operações seguras de filesystem, PTY e git
• Editor avançado (Monaco), terminal integrado (xterm.js) e componentes shadcn/ui + Tailwind

---

Arquitetura

┌──────────────────────────────────────────────────────────────────┐
│                        INTERFACE DO USUÁRIO                      │
│  File Tree │ Monaco Editor │ Agent Panel │ Terminal │ Settings   │
│  React + shadcn/ui + Tailwind + Zustand                          │
├──────────────────────────────────────────────────────────────────┤
│                     TAURI IPC BOUNDARY                           │
│  invoke()/emit()/listen() — comandos tipados                      │
├──────────────────────────────────────────────────────────────────┤
│                      TAURI RUST SHELL                            │
│  FS Commands │ PTY Manager │ Git Ops │ SQLite │ Process Sandbox   │
├──────────────────────────────────────────────────────────────────┤
│                     AGENT HARNESS (TS)                           │
│  Agent Loop │ Context Manager │ Tool Router │ SDD Engine         │
├──────────────────────────────────────────────────────────────────┤
│                    AI PROVIDER LAYER (TS)                        │
│  Anthropic │ OpenAI │ Gemini │ Ollama │ OpenRouter               │
├──────────────────────────────────────────────────────────────────┤
│                     MCP CLIENT (TS)                              │
│  @modelcontextprotocol/sdk │ stdio / SSE / WS transports         │
└──────────────────────────────────────────────────────────────────┘

---

Stack Tecnológico

• Desktop shell: Tauri v2 (Rust)
• Frontend: React + TypeScript
• UI: shadcn/ui + Tailwind CSS
• Estado: Zustand
• Editor de código: Monaco Editor
• Terminal: xterm.js + Tauri PTY
• Banco de dados: SQLite (tauri-plugin-sql)
• Monorepo: Turborepo + pnpm workspaces

---

Começando (rápido)

Pré-requisitos:

• Node.js 18+
• pnpm 10+
• Rust 1.70+
• Tauri CLI prerequisites — veja https://tauri.app/start/prerequisites/

Passos rápidos:

# Clonar o repositório
git clone https://github.com/Estevaobonatto/Hyscode.git
cd Hyscode

# Instalar dependências
pnpm install

# Rodar em modo dev (hot reload)
pnpm dev

Ao iniciar, a janela Tauri será aberta automaticamente.

---

Desenvolvimento

Scripts úteis (definidos em package.json):

• pnpm dev — inicia todos os apps em modo desenvolvimento (turbo dev)
• pnpm build — build do monorepo (turbo build)
• pnpm lint — executa linter
• pnpm typecheck — checagem de tipos TypeScript
• pnpm format — formata o código com Prettier

---

Build/Produção

Para gerar builds:

# Windows (script PowerShell que empacota o app)
pnpm run build:prod

# macOS / Linux
pnpm run build

Os instaladores ficam em apps/desktop/src-tauri/target/release/bundle/ após o build.

---

Estrutura do Repositório

Principais pastas:

apps/                 # apps (desktop Tauri + outras aplicações)
packages/             # bibliotecas compartilhadas (ai-providers, agent-harness, etc)
extensions/           # extensões empacotadas
docs/                 # documentação de arquitetura e especificações
scripts/              # scripts auxiliares

---

Documentação

Consulte os documentos em docs/ para detalhes de arquitetura e design:

• docs/architecture/OVERVIEW.md
• docs/architecture/AGENT_HARNESS.md
• docs/architecture/AI_PROVIDERS.md
• docs/architecture/MCP.md
• docs/architecture/FRONTEND.md
• docs/architecture/TAURI.md
• docs/EXTENSION_GUIDE.md
• docs/specs/MVP_SPEC.md

---

Contribuição

Contribuições são muito bem-vindas! Antes de abrir PRs, por favor leia CONTRIBUTING.md.

Sugestões para contribuir:

• Abra issues descrevendo bugs ou propostas de melhoria
• Crie uma branch por feature/bugfix (ex.: feat/agent-loop-improvement)
• Mantenha commits pequenos e com mensagens claras

---

Segurança

Para divulgação responsável de vulnerabilidades, veja SECURITY.md.

---

Licença

MIT — veja LICENSE para detalhes.

---

Se quiser ajuda para configurar o ambiente ou rodar o projeto localmente, me diga qual SO você está usando — eu posso guiar passo a passo.