Logo do Alethe

Alethe

O workspace de código com múltiplos agentes.
Rode Claude Code, Codex, Copilot e seus shells lado a lado, num único app desktop local-first.
English · 中文说明

CI Última versão Licença

Download · Reportar bug · Pedir feature · Segurança · Privacidade · Contribuir

> [!IMPORTANT] > O Alethe está numa versão pública inicial. O app desktop é gratuito, open source e local-first, > mas não totalmente offline: a verificação de atualizações e a consulta de uso dos provedores vêm > ligadas por padrão, e os outros recursos de rede são opcionais ou disparados por uma ação sua. A > sincronização manual via GitHub Gist já está disponível; sync ou backup hospedados pelo projeto > podem ser oferecidos separadamente no futuro. Veja o > [guia de privacidade e fluxo de dados](./docs/PRIVACY.md) (em inglês).
https://github.com/user-attachments/assets/e5e52485-51e8-476c-acf3-4a5a5400dacf
## O que é o Alethe Um agente num terminal é fácil. Cinco agentes em três repositórios é o trabalho de verdade, e é aí que abas de terminal param de funcionar: sessões se perdem, os servidores MCP de cada agente ficam diferentes, e ninguém sabe qual agente está fazendo o quê, e onde. **O Alethe é um workspace desktop feito para isso.** Cada agente roda num PTY real dentro de um layout de projeto persistente, mantém sua própria sessão e histórico, e continua vivo quando você reorganiza a interface. Além disso, o Alethe gerencia o que os agentes compartilham: os CLIs, os servidores MCP, as skills e as conversas que você passa de um para outro. Multiplataforma (Windows, macOS, Linux), local-first, feito com Tauri, Rust, React e `xterm.js`. "Local-first" descreve onde o workspace é salvo, não uma garantia de funcionar sem internet; veja [`docs/PRIVACY.md`](./docs/PRIVACY.md) para os padrões de rede, credenciais e retenção de dados. ## Plataformas suportadas
macOS Windows Linux
Alethe rodando no macOS Alethe rodando no Windows Alethe rodando no Linux
## Agentes | | Agente | CLI | | |:-:|---|---|---| | | **Claude Code** | `claude` | Retomada de sessão, cards de uso, histórico local | | | **Codex** | `codex` | Retomada de sessão, cards de uso | | | **GitHub Copilot CLI** | `copilot` | | | | **Cursor** | `cursor-agent` | Retomada de sessão | | | **Antigravity** | `agy` | Cards de uso | | | **OpenCode** | `opencode` | Retomada de sessão | | | **Kiro CLI** | `kiro-cli` | | | | **Kimi Code** | `kimi` | | | | **Grok Build** | `grok` | | | | **Codewhale** | `codewhale` | | | | **Mimo** | `mimo` | | | | **Freebuff** | `freebuff` | | | | **Shell** | pwsh / bash / zsh | O terminal comum, no mesmo modelo de painéis | | | **WSL** | `wsl.exe` | A distro padrão, como shell comum (Windows) | CLIs que faltam podem ser instalados, atualizados e desinstalados de dentro do Alethe. Ele verifica se a máquina tem Node, npm, WinGet, Scoop e Chocolatey e oferece só os métodos que funcionam ali, preferindo o instalador oficial de cada fornecedor. CLIs já instalados são encontrados no PATH, no registro e em npm/pnpm/Volta/fnm/nvm/Bun/Cargo/Scoop/Chocolatey, e podem apontar para um caminho personalizado. Um plugin pode adicionar o próprio agente a essa lista. Os agentes podem, opcionalmente, passar pelo [9router](https://github.com/decolua/9router), um proxy local que distribui o tráfego entre provedores com fallback automático. O Alethe instala e roda uma cópia própria, com versão fixa, sem mexer nos seus pacotes npm globais. O roteamento vem desligado e vale só para terminais abertos depois que ele é ligado. ## O que ele faz **Rodar agentes em paralelo** - Projetos, grupos e subgrupos organizam os repositórios; cada projeto aberto vira um container com seus próprios painéis. - Um agente por painel, ou vários agentes como sub-abas no mesmo painel, cada um com seu PTY, pasta de trabalho e sessão. - Layouts automático, spotlight, barra lateral e grade personalizada, editáveis direto na grade. - Fechar um container só o esconde; o processo continua rodando. **Manter o contexto** - Sessões do Claude Code, Codex, Cursor e OpenCode são retomadas depois de um crash ou reinício. - **Chats recentes** lista as conversas da pasta de trabalho de um painel e reabre qualquer uma. - Uma conversa do Claude Code pode ser **passada para o Codex** (e de volta) por um pacote de contexto com dados sensíveis removidos localmente, sem copiar a conversa à mão. A remoção é feita no melhor esforço, então revise o pacote antes de iniciar o agente de destino. - O histórico de saída de cada PTY é salvo, então ao reabrir você vê o que aconteceu antes. **Gerenciar o que os agentes compartilham** - **Aba MCP**: todos os servidores MCP configurados na máquina, agrupados por servidor e mostrando quais agentes os têm, lidos das configs do Claude Code, Codex, Cursor, OpenCode e Antigravity. Adicione, remova, copie um servidor de um agente para outro, busque no registro oficial e peça a cada agente para confirmar que consegue acessar um servidor. Toda gravação tem backup, é validada de novo e aplicada de forma atômica. - **Aba Skills**: as skills instaladas de cada agente, com links e pastas compartilhadas resolvidos, para que uma skill compartilhada apareça uma vez só. - **Graphify**: um grafo do código do projeto, servido aos agentes como servidor MCP. **Estender com plugins** - Recursos são carregados como **plugins**, não como código fixo. Os oficiais (Todo List, Git Control, Theme Pack) vêm no instalador e podem ser desligados em Preferências ▸ Plugins, aparecendo e sumindo sem reiniciar o app. - Um plugin pode adicionar um painel, uma aba na barra lateral, um comando na paleta, um tema completo ou um novo provedor de agente. Ele declara o que precisa no manifesto, e o app recusa qualquer coisa que ele não pediu. - **Catálogo de plugins**: plugins publicados por outras pessoas aparecem no Alethe com as permissões descritas, e os que têm pacote instalam e atualizam com um clique. O índice fixa cada pacote num checksum SHA-256, então o que roda é exatamente o que foi revisado. Um plugin instalado chega desligado e passa por uma tela de confiança antes de rodar. Para publicar um plugin, veja a seção *Publishing a plugin* do [README em inglês](./README.md) e o [guia de plugins](docs/PLUGINS.md). **Ficar no controle** - Uso de RAM na barra de título; desative um terminal ou suspenda um grupo inteiro para liberar memória. - Painel Git por projeto (status, stage, commit, branches, diffs num painel), mais worktrees para tarefas em paralelo. - **Revisão de Pull Request**: o painel de merge encontra o PR aberto no GitHub para o worktree de um agente usando o CLI `gh` local, mostra os dados dele e pode iniciar uma revisão por IA no mesmo worktree isolado, só de leitura, sem commits, pushes, merges ou comentários no GitHub. O squash merge continua sendo uma ação humana explícita, bloqueada quando o SHA do head mudou, o PR é rascunho ou o GitHub aponta conflitos. Nenhum token do GitHub é salvo; a autenticação fica com o `gh`. - Painéis de conteúdo ao lado dos terminais: explorador de arquivos, Markdown, diffs, imagens, vídeo, navegador embutido. - Tarefas por projeto com timer Pomodoro, perfis isolados, exportação e importação de backup local, temas de interface e de terminal, idiomas EN, pt-BR e zh-CN. - **Quadro de orquestração**: um agente líder delega partes do trabalho para workers Claude e Codex que o Alethe roda em paralelo, cada um opcionalmente no próprio worktree git, mostrando status, custo, tokens e diff no seu card, e podendo pedir sua permissão antes de sair do sandbox. Vem desligado. - **Ditado por voz local** com um modelo que roda no seu computador, e **sync na nuvem** das suas preferências via login no GitHub. Ambos opcionais. - **Controle remoto**: uma página web autenticada na rede local, pareada por QR code, para acompanhar e responder os agentes pelo celular. Vem desligado e usa HTTP/WebSocket sem criptografia na rede local, então só ligue numa rede confiável. - Spotify "tocando agora", usando as credenciais do seu próprio app do Spotify em **Preferências ▸ Spotify**, com `http://127.0.0.1:8888/callback` como URI de redirecionamento. ## Conceitos principais | | | |---|---| | **Grupo** | Um conjunto de projetos que abre, recolhe e suspende junto. | | **Projeto** | Um contexto de trabalho salvo: terminais, layout, cor, estado local. | | **Container** | A moldura visível de um projeto aberto. Fechar não encerra nada. | | **Painel** | Uma visão de terminal dentro de um container. | | **Sub-aba** | Uma sessão separada de agente ou shell dentro do mesmo painel. | | **PTY** | O processo real no backend, vivo independente da interface. | ## Filosofia do produto Um núcleo focado com recursos opcionais, mais perto do Obsidian do que de uma IDE maximalista. Recursos não essenciais ficam atrás de feature flags ou configurações opcionais, e uma instalação limpa continua sendo uma experiência completa. Coerência acima de volume. ## Instalação Use os instaladores publicados em [Releases](https://github.com/Kc1t/alethe-agents/releases). > [!WARNING] > As versões para Windows **ainda não são assinadas**, então o Defender pode marcar o `alethe.exe` > como `Trojan:Win32/Bearfoos.A!ml` e colocá-lo em quarentena. O sufixo `!ml` indica uma heurística > de machine learning, não uma assinatura de vírus conhecida, e o comportamento de um multiplexador > de terminal (criar processos filhos e PTYs) pode gerar falsos positivos. Confira se o download veio > da página oficial de Releases; não ignore o aviso para um arquivo de outra origem. Para recuperar: **Segurança do Windows → Proteção contra vírus e ameaças → Histórico de proteção → Ações → Restaurar**, e adicione uma exclusão para `%LOCALAPPDATA%\Alethe` (e `src-tauri/target`, se compilar do código-fonte). No macOS as versões também ainda não são notarizadas: clique com o botão direito no app e escolha **Abrir** para passar pelo Gatekeeper. ## Rodar a partir do código-fonte ```sh git clone https://github.com/Kc1t/alethe-agents.git cd alethe-agents npm install npm run app ``` Requisitos: Node.js 18+, Rust stable, Visual Studio Build Tools no Windows, e as dependências de sistema do Tauri no Linux: ```sh sudo apt install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf ``` ```sh npm run app # app desktop com hot reload npm run dev # só o frontend npm run build # typecheck + build do frontend npm run tauri build # instaladores → src-tauri/target/release/bundle/ ``` ## Comando no terminal Instale o comando `alethe` em **Configurações ▸ Integrações ▸ Comando de terminal**: ```bash alethe # abre a pasta atual como projeto alethe ~/algum/projeto # abre a pasta indicada ``` Se a pasta já for um projeto, ele é trazido para o workspace em vez de duplicado. Se o Alethe já estiver aberto, a janela existente ganha o foco. O comando fica em `~/.local/bin/alethe` (macOS/Linux) ou `%LOCALAPPDATA%\Alethe\bin\alethe.cmd` (Windows); reinstale depois de mover o app. ## Roadmap - [x] Workspace multiagente com projetos, grupos, containers e sub-abas. - [x] PTYs reais com spawn, attach, resize, histórico de saída e retomada de sessão. - [x] Instalar, atualizar e desinstalar agentes; gerenciar MCP e skills. - [x] Versões para Windows, Linux e macOS. - [ ] Assinatura das versões para Windows e notarização no macOS. - [ ] Validação mais ampla em máquinas reais com Linux e macOS. - [ ] Sync e backup na nuvem hospedados pelo projeto (o sync manual via GitHub Gist já existe). ## Contribuindo Contribuições são bem-vindas. Leia o [`CONTRIBUTING.md`](CONTRIBUTING.md) (em inglês) para setup, estrutura do projeto e regras da casa. Os jeitos mais fáceis de ajudar: - Pegue uma issue marcada como [`good first issue`](https://github.com/Kc1t/alethe-agents/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) ou [`help wanted`](https://github.com/Kc1t/alethe-agents/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) e comente para reservá-la. - Reporte um bug com passos claros para reproduzir, ou peça uma feature explicando o fluxo que ela melhora. - Melhore documentação, screenshots e testes em outras plataformas; Linux e macOS são os menos testados. Para mudanças maiores, abra uma issue antes para discutir a direção. A lista de contribuidores, os vídeos e os projetos feitos com o Alethe ficam no [README em inglês](./README.md#contributors), que é atualizado automaticamente. ## Licença O código-fonte é distribuído sob **AGPL-3.0-or-later**. Modificações e obras derivadas que forem distribuídas, ou disponibilizadas a usuários pela rede, precisam fornecer o código-fonte correspondente sob a mesma licença. Veja [`LICENSE`](LICENSE) e [`NOTICE`](NOTICE). Serviços oficiais hospedados, como sync, backup, cobrança ou recursos na nuvem, podem ser proprietários e oferecidos separadamente. A licença do código não dá direitos sobre o nome **Alethe**, o logo, o ícone do app ou a marca oficial. Builds modificadas precisam ter marca própria, e o uso comercial da marca Alethe exige permissão prévia por escrito de Kauã Miguel. Veja [`TRADEMARK.md`](TRADEMARK.md). ## Comunidade - Relatos de segurança: [`SECURITY.md`](SECURITY.md) - Privacidade e fluxo de dados: [`docs/PRIVACY.md`](docs/PRIVACY.md) - Mantenedor: [Kc1t](https://github.com/Kc1t) - Projeto: - Bugs e pedidos de feature: