opencode-android/README.it.md at main · hi77x/opencode-android

L’agente di coding AI open source.

opencode per 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.

Questo fork esegue l'opencode esistente in modo nativo su Android: il telefono esegue il vero server, l'agente, le sessioni e l'interfaccia invariata di packages/app (via loopback in una WebView). Niente PC, niente Termux, niente server remoto e nessuna modifica al protocollo.

Cosa abbiamo aggiunto noi (tutto il resto è opencode upstream):

Percorso	Contenuto
`packages/android`	Host Android: progetto Gradle, activity WebView, server incorporato, adattamenti mobili dell'interfaccia
`script/android`	Build riproducibile: `build-apk.sh` e script per server, ripgrep, runtime git e traduzioni
`docs/android`	Documenti tecnici: build, policy di esecuzione, dipendenze native, patch upstream

Solo cinque file upstream sono modificati (target di build Android e compatibilità del runtime); ognuno è motivato in docs/android/UPSTREAM_PATCHES.md.

Come funziona: l'activity avvia il server incorporato (libopencode.so serve --hostname=127.0.0.1) e carica http://127.0.0.1:<port>/ nella WebView. Gli strumenti vengono eseguiti dalla directory delle librerie native: /system/bin/sh, git, rg inclusi e un runtime Bun esposto come bun/node.

Download: releases (app-release.apk, arm64, Android 8.0+)
Build: ./script/android/build-apk.sh — vedi docs/android/BUILD.md
Primo avvio: concedi l'accesso ai file (le sessioni sono in /sdcard/OpenCode/home e sopravvivono alle reinstallazioni), poi Impostazioni → Provider → collega un provider e aggiungi un progetto (~/workspace)
Funziona: server e interfaccia web, sessioni, git con diff ed evidenziazione (Changes), browser dei file (Files), pannello di utilizzo del contesto (Usage), esecuzione di comandi e JS/TS
Limiti: niente terminale PTY, LSP/formatter, processi MCP locali; il file watcher nativo non è disponibile (la ricerca usa rg)
Licenza: MIT, come l'originale

Installazione

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

# Package manager
npm i -g opencode-ai@latest        # oppure bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS e Linux (consigliato, sempre aggiornato)
brew install opencode              # macOS e Linux (formula brew ufficiale, aggiornata meno spesso)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # Qualsiasi OS
nix run nixpkgs#opencode           # oppure github:anomalyco/opencode per l’ultima branch di sviluppo

Tip

Rimuovi le versioni precedenti alla 0.1.x prima di installare.

App Desktop (BETA)

OpenCode è disponibile anche come applicazione desktop. Puoi scaricarla direttamente dalla pagina delle release oppure da opencode.ai/download.

Piattaforma	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`, oppure AppImage

App mobile (BETA)

OpenCode funziona anche su Android come APK nativa compilata da questo fork. L'app include il vero server e la stessa interfaccia web; sessioni, chiavi dei provider e progetti sono in /sdcard/OpenCode/home e sopravvivono alle reinstallazioni.

Piattaforma	Download	Note
Android 8.0+ (arm64)	`app-release.apk`	BETA — concedi l'accesso ai file al primo avvio
Build dai sorgenti	`./script/android/build-apk.sh`	vedi `packages/android/README.md`

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

Directory di installazione

Lo script di installazione rispetta il seguente ordine di priorità per il percorso di installazione:

$OPENCODE_INSTALL_DIR – Directory di installazione personalizzata
$XDG_BIN_DIR – Percorso conforme alla XDG Base Directory Specification
$HOME/bin – Directory binaria standard dell’utente (se esiste o può essere creata)
$HOME/.opencode/bin – Fallback predefinito

# Esempi
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

Agenti

OpenCode include due agenti integrati tra cui puoi passare usando il tasto Tab.

build – Predefinito, agente con accesso completo per il lavoro di sviluppo
plan – Agente in sola lettura per analisi ed esplorazione del codice
- Nega le modifiche ai file per impostazione predefinita
- Chiede il permesso prima di eseguire comandi bash
- Ideale per esplorare codebase sconosciute o pianificare modifiche

È inoltre incluso un sotto-agente general per ricerche complesse e attività multi-step. Viene utilizzato internamente e può essere invocato usando @general nei messaggi.

Scopri di più sugli agenti.

Documentazione

Per maggiori informazioni su come configurare OpenCode, consulta la nostra documentazione.

Contribuire

Se sei interessato a contribuire a OpenCode, leggi la nostra guida alla contribuzione prima di inviare una pull request.

Costruire su OpenCode

Se stai lavorando a un progetto correlato a OpenCode e che utilizza “opencode” come parte del nome (ad esempio “opencode-dashboard” o “opencode-mobile”), aggiungi una nota nel tuo README per chiarire che non è sviluppato dal team OpenCode e che non è affiliato in alcun modo con noi.

Unisciti alla nostra community Discord | X.com

FilesExpand file tree

README.it.md

Latest commit

History