@alltomatos/opencode

OpenCode by Alltomatos — a fork of the open source AI coding agent.

Grupo de Apoio: https://chat.whatsapp.com/DOLzfQ4aPZ12R7ZRbLabNh

Screenshots

Este é um fork pessoal do OpenCode, mantido por Alltomatos, com o foco no app desktop para Windows e ajustes de UI/UX específicos deste fork (sidebar de projetos, terminal e browser embutidos no cabeçalho da sessão, seed de skills padrão, entre outros — veja o changelog e as releases para o histórico completo).

Branches

Este fork trabalha com duas branches:

• prod — branch de produção. Só ela gera releases publicados (o app instalado e o auto-updater apontam pra cá). É pra onde dev é promovida quando um lote de mudanças está maduro.
• dev — branch de desenvolvimento. Todo o trabalho novo (features, correções, UI/UX) acontece aqui primeiro, roda em modo dev localmente pra validar, e só depois é promovida pra prod.

App Desktop (produção)

Baixe o instalador direto na página de releases — sempre gerado a partir da branch prod.

No Windows, baixe e rode o opencode-desktop-win-x64.exe (instalador NSIS) — sem necessidade de script. No macOS e Linux, baixe o instalador correspondente e instale manualmente (.dmg, dpkg -i *.deb, rpm -i *.rpm, ou dê permissão de execução no .AppImage).

Nota (macOS): os builds de Mac não são assinados/notarizados por este fork (não temos uma conta Apple Developer configurada). Na primeira abertura o Gatekeeper vai avisar que o app "não pode ser verificado" — clique com o botão direito no app → Abrir para liberar manualmente.

O app verifica atualizações automaticamente contra este repositório (alltomatos/opencode), não contra o projeto original.

Rodando em desenvolvimento

Pra validar mudanças antes de promover dev pra prod, rode o app desktop localmente a partir da branch dev:

git clone https://github.com/alltomatos/opencode.git
cd opencode
git checkout dev
bun install
cd packages/desktop
bun run dev

Isso abre o Electron em modo desenvolvimento (canal dev, auto-update desativado, ícone de dev). Pra buildar um instalador local sem publicar:

cd packages/desktop
OPENCODE_CHANNEL=prod bun run build
bun run package:win     # Windows (feito manualmente nesta máquina)
bun run package:mac     # macOS — precisa rodar num Mac
bun run package:linux   # Linux — precisa de dpkg/rpm/fpm disponíveis

O instalador gerado fica em packages/desktop/dist/.

Publicação real é automática: assim que a branch prod recebe um push (a promoção dev → prod), o workflow release-desktop.yml dispara sozinho e builda Windows/macOS/Linux em paralelo (windows-latest/macos-latest/ubuntu-latest), publicando os três num único release do GitHub com a versão que estiver em packages/desktop/package.json no momento do push. Não precisa mais buildar nada manualmente nesta máquina — só bumpar a versão, commitar, e promover. Pra reexecutar manualmente (ex: retry de uma plataforma que falhou), use gh workflow run release-desktop.yml.

CLI via npm (canais dev/prod)

Além do app desktop, o CLI deste fork é publicado direto no npm sob o escopo @alltomatos, separado dos pacotes opencode-ai/@opencode-ai/* do projeto original — instala com canal via a sintaxe @tag do próprio npm:

npm install -g @alltomatos/opencode@dev     # última publicada a cada push em dev
npm install -g @alltomatos/opencode@latest  # última publicada a cada push em prod

Publicação é automática pelo workflow release-npm-fork.yml: builda os binários (cross-compilados num único runner) e publica com a tag correspondente à branch. Útil pra testar mudanças de dev via CLI/servidor sem precisar instalar o app desktop.

Memória entre sessões

Este fork adiciona um sistema de memória cross-sessão (global e por projeto), habilitado por padrão. O modelo tem acesso a duas tools sob demanda — memory_search (consulta memórias relevantes) e memory_save (registra algo pra lembrar depois) — chamadas quando o próprio modelo decide que é relevante, sem injetar tudo automaticamente em todo prompt.

• Ativar/desativar e escolher modelo: Configurações → Memória (mesmo padrão de toggle instantâneo do resto do app).
• Memória global (~/.local/share/opencode/memory/global/) fica disponível como skill carregada automaticamente em qualquer sessão/projeto, além de consultável via memory_search.
• Memória por projeto (~/.local/share/opencode/memory/projects/<projeto>/) fica isolada por diretório.

Rodando numa VPS (servidor remoto)

O OpenCode também roda como servidor puro, sem o app desktop — útil pra manter sessões ativas 24/7 e acessar de qualquer lugar.

export OPENCODE_SERVER_PASSWORD="uma-senha-forte-aqui"
opencode web --hostname 0.0.0.0 --port 4096      # UI web embutida, acessível pelo navegador
# ou
opencode serve --hostname 0.0.0.0 --port 4096    # só a API, pra conectar via app desktop ou TUI

Depois é só adicionar esse endereço como servidor remoto em Configurações → Servidores no app desktop, ou abrir a URL direto no navegador. Guia completo (systemd, proxy reverso/TLS, segurança) em docs/vps-hosting.md.

Bot do Telegram: conecte em Configurações → Integrações → Telegram (token do @BotFather). Cada pedido roda em segundo plano; se um turno ficar travado (ex.: uma pergunta sem resposta) ele cancela sozinho depois de 10 minutos e avisa no chat — ou use /cancel pra cancelar na hora, sem precisar reiniciar o servidor. /new começa uma sessão nova a qualquer momento.

Abas do app: Code e AgentUI

O app desktop organiza o trabalho em abas na barra lateral:

• Code — a aba padrão: sessões de codificação normais, com o agente OpenCode operando no seu projeto (terminal e browser embutidos, permissões, etc).
• AgentUI — construtor de agentes de chat próprios: configure um agente com system prompt, modelo e skills selecionadas, teste num sandbox de chat embutido, e habilite/desabilite por sessão. Editor baseado em páginas, direto na sidebar.

Agents

OpenCode includes two built-in agents you can switch between with the Tab key.

• build - Default, full-access agent for development work
• plan - Read-only agent for analysis and code exploration
  • Denies file edits by default
  • Asks permission before running bash commands
  • Ideal for exploring unfamiliar codebases or planning changes

Also included is a general subagent for complex searches and multistep tasks. This is used internally and can be invoked using @general in messages.

Learn more about agents in the original project's docs.

Documentation

A documentação de configuração geral segue a do projeto original: opencode.ai/docs. Diferenças específicas deste fork (sidebar de projetos, seed de skills, canal de atualização, etc.) não estão documentadas lá — consulte o changelog deste repositório.

Créditos

Este fork existe graças ao trabalho da equipe original do OpenCode (anomalyco). Todo o núcleo do produto — o agente de codificação, a TUI, o protocolo, o SDK — vem do projeto original; este fork adiciona e ajusta principalmente a camada do app desktop.

• Projeto original: github.com/anomalyco/opencode
• Site oficial: opencode.ai
• Discord oficial: opencode.ai/discord

Se você não está procurando especificamente por este fork, use o projeto original

Building on OpenCode

If you are working on a project that's related to OpenCode and is using "opencode" as part of its name, for example "opencode-dashboard" or "opencode-mobile", please add a note to your README to clarify that it is not built by the OpenCode team and is not affiliated with them in any way.