Skip to content

README.br.md

Latest commit

 

History

History
167 lines (126 loc) · 8.81 KB

README.br.md

File metadata and controls

167 lines (126 loc) · 8.81 KB
Raw

Logo do OpenCode

O agente de programação com IA de código aberto.

Discord npm Build status

English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt

opencode para Android

Important

Android data survives reinstall only if all-files access is granted: server data is stored under /sdcard/OpenCode/home; otherwise app-private data is removed on uninstall. You may need to reselect a project after reinstalling. The v0.1.1 source tag predates the Android module; build from main. The uploaded APK has not been verified as a byte-for-byte build of main. See the current Android notes.

Este fork executa o opencode existente de forma nativa no Android: o celular roda o servidor real, o agente, as sessões e a interface inalterada do packages/app (via loopback em um WebView). Sem PC, sem Termux, sem servidor remoto e sem mudanças de protocolo.

O que nós adicionamos (todo o resto é opencode upstream):

Caminho Conteúdo
packages/android Host Android: projeto Gradle, activity WebView, servidor embutido, adaptações móveis da interface
script/android Build reproduzível: build-apk.sh e scripts para servidor, ripgrep, runtime do git e traduções
docs/android Documentos técnicos: build, política de execução, dependências nativas, patches upstream

Apenas cinco arquivos upstream são modificados (alvo de build Android e compatibilidade de runtime); cada um é justificado em docs/android/UPSTREAM_PATCHES.md.

Como funciona: a activity inicia o servidor embutido (libopencode.so serve --hostname=127.0.0.1) e carrega http://127.0.0.1:<port>/ no WebView. As ferramentas rodam do diretório de bibliotecas nativas: /system/bin/sh, git, rg incluídos e um runtime Bun exposto como bun/node.

  • Download: releases (app-release.apk, arm64, Android 8.0+)
  • Build: ./script/android/build-apk.sh — veja docs/android/BUILD.md
  • Primeira execução: conceda acesso a arquivos (as sessões ficam em /sdcard/OpenCode/home e sobrevivem a reinstalações), depois Configurações → Provedores → conecte um provedor e adicione um projeto (~/workspace)
  • Funciona: servidor e interface web, sessões, git com diffs e realce de sintaxe (Changes), navegador de arquivos (Files), painel de uso de contexto (Usage), execução de comandos e JS/TS
  • Limitações: sem terminal PTY, sem LSP/formatadores, sem processos MCP locais; o file watcher nativo não está disponível (a busca usa rg)
  • Licença: MIT, como o original

OpenCode Terminal UI

Instalação

# YOLO
curl -fsSL https://opencode.ai/install | bash

# Gerenciadores de pacotes
npm i -g opencode-ai@latest        # ou bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS e Linux (recomendado, sempre atualizado)
brew install opencode              # macOS e Linux (fórmula oficial do brew, atualiza menos)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # qualquer sistema
nix run nixpkgs#opencode           # ou github:anomalyco/opencode para a branch dev mais recente

Tip

Remova versões anteriores a 0.1.x antes de instalar.

App desktop (BETA)

O OpenCode também está disponível como aplicativo desktop. Baixe diretamente pela página de releases ou em opencode.ai/download.

Plataforma Download
macOS (Apple Silicon) opencode-desktop-mac-arm64.dmg
macOS (Intel) opencode-desktop-mac-x64.dmg
Windows opencode-desktop-windows-x64.exe
Linux .deb, .rpm ou AppImage

Aplicativo móvel (BETA)

O OpenCode também roda no Android como APK nativa compilada deste fork. O app inclui o servidor real e a mesma interface web; sessões, chaves de provedores e projetos ficam em /sdcard/OpenCode/home e sobrevivem a reinstalações.

Plataforma Download Notas
Android 8.0+ (arm64) app-release.apk BETA — conceda acesso a arquivos na primeira execução
Compilar do código-fonte ./script/android/build-apk.sh veja packages/android/README.md 
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

Diretório de instalação

O script de instalação respeita a seguinte ordem de prioridade para o caminho de instalação:

  1. $OPENCODE_INSTALL_DIR - Diretório de instalação personalizado
  2. $XDG_BIN_DIR - Caminho compatível com a especificação XDG Base Directory
  3. $HOME/bin - Diretório binário padrão do usuário (se existir ou puder ser criado)
  4. $HOME/.opencode/bin - Fallback padrão
# Exemplos
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

Agents

O OpenCode inclui dois agents integrados, que você pode alternar com a tecla Tab.

  • build - Padrão, agent com acesso total para trabalho de desenvolvimento
  • plan - Agent somente leitura para análise e exploração de código
    • Nega edições de arquivos por padrão
    • Pede permissão antes de executar comandos bash
    • Ideal para explorar codebases desconhecidas ou planejar mudanças

Também há um subagent general para buscas complexas e tarefas em várias etapas. Ele é usado internamente e pode ser invocado com @general nas mensagens.

Saiba mais sobre agents.

Documentação

Para mais informações sobre como configurar o OpenCode, veja nossa documentação.

Contribuir

Se você tem interesse em contribuir com o OpenCode, leia os contributing docs antes de enviar um pull request.

Construindo com OpenCode

Se você estiver trabalhando em um projeto relacionado ao OpenCode e estiver usando "opencode" como parte do nome (por exemplo, "opencode-dashboard" ou "opencode-mobile"), adicione uma nota no README para deixar claro que não foi construído pela equipe do OpenCode e não é afiliado a nós de nenhuma forma.

Junte-se à nossa comunidade Discord | X.com