Documentação do Devia Desktop

O que é o Devia Desktop?

O Devia Desktop é uma aplicação de secretária para desenvolver software com agentes de IA. É uma interface amigável e unificada sobre múltiplas ferramentas CLI agênticas (Claude Code, Codex, Gemini CLI e mais) que transforma o trabalho com agentes em terminal numa experiência visual, organizada e multiprojeto.

É FreeWare: grátis com 100% das funcionalidades, disponível para Windows, macOS e Linux. Tudo funciona em local, sobre os teus projetos e os teus CLIs; não necessita de conta nem de ligação a qualquer serviço.

Instalação

Windows

1. Transfere o instalador .exe a partir da página de transferências.
2. Executa-o e escolhe o diretório de instalação (instalação por utilizador, sem permissões de administrador).
3. Se o SmartScreen mostrar um aviso, clica em «Mais informações → Executar mesmo assim».

macOS

1. Transfere o .dmg para a tua arquitetura (Apple Silicon ou Intel).
2. Abre-o e arrasta o Devia para a pasta Aplicações.
3. A app está assinada e notariada pela Apple: abre sem passos adicionais.

Linux

1. AppImage: transfere-o, dá-lhe permissões com chmod +x Devia-*.AppImage e executa-o.
2. Debian/Ubuntu: instala o pacote com sudo dpkg -i devia_*_amd64.deb.

Primeiros passos

1. Escolhe o teu workspace. Na primeira vez que abres o Devia, um modal pede-te a pasta raiz onde vivem os teus projetos (por exemplo ~/repos). O Devia lista os projetos que contém e deteta a sua tecnologia.
2. Liga um agente. O Devia deteta os CLIs agênticos instalados na tua máquina e permite-te escolher o agente ativo nas Definições. Cada projeto fica configurado para que o agente funcione sem ajustes manuais.
3. Conversa. Abre um projeto e escreve a tua primeira instrução no compositor. Escolhe o modo de execução — plan (só planeia), apply (aplica com permissões) ou apply-yolo (sem confirmações) — consoante a autonomia que queres dar.
4. Revê. Cada resposta chega em streaming com markdown, as chamadas a ferramentas expandem-se em cartões e as alterações do agente aparecem como diffs em linha.

Agentes compatíveis

O Devia funciona com os seguintes CLIs de codificação, e podes mudar de um para outro sem sair da app:

Ao continuar uma sessão com um agente diferente do que a iniciou, o Devia faz uma transferência de contexto automática: injeta um resumo do trabalho (objetivo, ficheiros alterados e últimas trocas) no primeiro turno do novo agente e deixa um divisor no chat.

Funcionalidades

Multiprojeto e sessões

• Listagem, criação (vazio ou a partir de modelo) e clonagem de projetos; fixação de favoritos na barra lateral.
• Histórico de sessões por projeto que sobrevive a reinícios; continua ou reinicia uma sessão com um clique.
• Fila de instruções: coloca prompts em fila enquanto o agente está ocupado, reordena com arrastar e largar, pausa e retoma.

Vista dividida multissessão

• Até 4 painéis (2×2) na mesma janela, cada um com a sua própria sessão e o seu agente a trabalhar em paralelo.
• Cada painel adicional trabalha isolado no seu próprio git worktree (novo ramo a partir do ramo principal) para que dois agentes nunca interfiram nos mesmos ficheiros.
• A divisão e os seus worktrees sobrevivem ao reinício da app, recuperando os ficheiros de cada sessão.

Kanban com SDD integrado

• Quadro Kanban por projeto com specs, tarefas e dependências.
• O próprio agente lê e atualiza o quadro via MCP (devia-kanban): fluxo spec-driven development de ponta a ponta.
• O estado vive fora do repositório, na pasta de dados do Devia.

Memória persistente

• Memória própria entre sessões (devia-memory) com âmbito pessoal e por projeto.
• O agente consulta-a e alimenta-a automaticamente: decisões, bugs resolvidos e descobertas ficam registados.
• Painel de gestão nas Definições: pesquisa, fixa, esquece ou limpa observações.

Git integrado

• Estado do repositório em tempo real na barra lateral.
• Visualizador de alterações com comentários em linha: anota linhas do diff e envia-as ao agente como pedido de revisão.
• Suporte a worktrees e snapshots com rollback antes de operações destrutivas.

Servidores MCP, skills e prompts

• Gestor de servidores Model Context Protocol: instala, ativa, testa e partilha servidores entre agentes; o Devia injeta a configuração no formato nativo de cada CLI.
• Descobre e instala skills locais ou a partir do GitHub.
• Prompt packs: pacotes de prompt de sistema por projeto.
• Gestor de sub-agentes multi-CLI reutilizáveis entre projetos.

Controlo remoto por Telegram

• Lança execuções, consulta o estado (ramo, contexto utilizado, custo) e conversa com o agente a partir do Telegram.
• Espelho opcional da conversa de secretária e envio de anexos (fotos, documentos) ao agente.

Terminal, voz e mais

• Terminal integrado por projeto com PTY real, e abertura do projeto no teu IDE favorito.
• Orquestração de Docker Compose: deploy, down e logs por projeto.
• Transcrição de voz local com Whisper — o áudio nunca sai da tua máquina.
• Anexos de imagem com arrastar e largar para modelos multimodais.
• Navegador de ficheiros do projeto no painel direito e arquivo de ficheiros gerados pelo agente (outbox).
• Registo de auditoria de cada tool-call com rotação e retenção de 30 dias.
• 11 idiomas (es, en, ca, fr, de, it, pt, ru, zh, hi, ar), 8 paletas de destaque Material 3 e tamanho de letra ajustável.

Configuração e dados

Toda a informação do Devia vive no teu disco, em ~/.devia-app/ (no Windows, C:\Users\<tu-usuario>\.devia-app\):

Para fazer uma cópia de segurança do teu Devia basta copiar essa pasta. Eliminá-la repõe a app ao estado inicial.

Atualizações

As versões publicadas são anunciadas no manifesto público deste site: updates/latest.json. Contém a última versão disponível, a data de publicação, as notas e as hiperligações de transferência por plataforma.

O Devia Desktop consulta esse manifesto para te avisar de que existe uma nova versão. Também podes verificá-lo manualmente ou a partir dos teus scripts:

curl -s https://dherrero.github.io/devia/updates/latest.json | jq .version

Perguntas frequentes

O Devia é gratuito?

Sim. O Devia Desktop é FreeWare com 100% das funcionalidades, em todas as plataformas.

Preciso de conta ou ligação a algum serviço do Devia?

Não. O Devia Desktop funciona completamente em local. Os únicos serviços externos utilizados são os dos próprios agentes CLI que tens configurados.

O Devia inclui os agentes de IA?

Não: o Devia é a interface que os dirige. Precisas de ter instalado pelo menos um CLI agêntico (Claude Code, Codex, Gemini CLI, OpenCode…) com as suas credenciais. O Devia deteta-os e trata do resto.

Os meus dados saem da minha máquina?

Não. Sessões, memória, kanban e configuração vivem em ~/.devia-app/. A transcrição de voz com Whisper também é executada em local. O único tráfego gerado é o que o agente CLI que usas envia ao seu próprio fornecedor.

Em que idiomas está disponível?

Espanhol, inglês, valenciano, francês, alemão, italiano, português, russo, chinês, hindi e árabe.

Como reporto um problema?

Abre uma issue no repositório GitHub do Devia com os passos para o reproduzir e a tua plataforma (Windows/macOS/Linux).