L'agent de codage IA open source.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
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.
Ce fork fait tourner l'opencode existant nativement sur Android : le téléphone exécute le vrai serveur, l'agent, les sessions et l'interface inchangée de packages/app (via loopback dans une WebView). Pas de PC, pas de Termux, pas de serveur distant, aucune modification du protocole.
Ce que nous avons ajouté par rapport à l'upstream (tout le reste est l'opencode upstream) :
| Chemin | Contenu |
|---|---|
packages/android |
Hôte Android : projet Gradle, activité WebView, serveur embarqué, adaptations mobiles de l'interface |
script/android |
Build reproductible : build-apk.sh et les scripts serveur, ripgrep, runtime git et traductions |
docs/android |
Documents techniques : build, politique d'exécution, dépendances natives, patchs upstream |
Seuls cinq fichiers upstream sont modifiés (cible de build Android et compatibilité d'exécution) ; chacun est justifié dans docs/android/UPSTREAM_PATCHES.md.
Fonctionnement : l'activité démarre le serveur embarqué (libopencode.so serve --hostname=127.0.0.1) et charge http://127.0.0.1:<port>/ dans une WebView. Les outils s'exécutent depuis le répertoire des bibliothèques natives : /system/bin/sh, git, rg embarqués et un runtime Bun exposé en bun/node.
- Téléchargement : releases (
app-release.apk, arm64, Android 8.0+) - Build :
./script/android/build-apk.sh— voirdocs/android/BUILD.md - Premier lancement : accordez l'accès aux fichiers (les sessions sont dans
/sdcard/OpenCode/homeet survivent aux réinstallations), puis Paramètres → Fournisseurs → connectez un fournisseur et ajoutez un projet (~/workspace) - Fonctionne : serveur et interface web, sessions, git avec diffs et coloration syntaxique (Changes), navigateur de fichiers (Files), panneau d'utilisation du contexte (Usage), exécution de commandes et de JS/TS
- Limites : pas de terminal PTY, ni LSP/formateurs, ni processus MCP locaux ; le file watcher natif est absent (recherche via
rg) - Licence : MIT, comme l'original
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Gestionnaires de paquets
npm i -g opencode-ai@latest # ou bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS et Linux (recommandé, toujours à jour)
brew install opencode # macOS et Linux (formule officielle brew, mise à jour moins fréquente)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # n'importe quel OS
nix run nixpkgs#opencode # ou github:anomalyco/opencode pour la branche dev la plus récenteTip
Supprimez les versions antérieures à 0.1.x avant d'installer.
OpenCode est aussi disponible en application de bureau. Téléchargez-la directement depuis la page des releases ou opencode.ai/download.
| Plateforme | Téléchargement |
|---|---|
| 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 |
OpenCode fonctionne aussi sur Android via une APK native issue de ce fork. L'application embarque le vrai serveur et la même interface web ; les sessions, clés de fournisseurs et projets sont dans /sdcard/OpenCode/home et survivent aux réinstallations.
| Plateforme | Téléchargement | Notes |
|---|---|---|
| Android 8.0+ (arm64) | app-release.apk |
BETA — accordez l'accès aux fichiers au premier lancement |
| Build depuis les sources | ./script/android/build-apk.sh |
voir packages/android/README.md |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktopLe script d'installation respecte l'ordre de priorité suivant pour le chemin d'installation :
$OPENCODE_INSTALL_DIR- Répertoire d'installation personnalisé$XDG_BIN_DIR- Chemin conforme à la spécification XDG Base Directory$HOME/bin- Répertoire binaire utilisateur standard (s'il existe ou peut être créé)$HOME/.opencode/bin- Repli par défaut
# Exemples
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 | bashOpenCode inclut deux agents intégrés que vous pouvez basculer avec la touche Tab.
- build - Par défaut, agent avec accès complet pour le travail de développement
- plan - Agent en lecture seule pour l'analyse et l'exploration du code
- Refuse les modifications de fichiers par défaut
- Demande l'autorisation avant d'exécuter des commandes bash
- Idéal pour explorer une base de code inconnue ou planifier des changements
Un sous-agent general est aussi inclus pour les recherches complexes et les tâches en plusieurs étapes.
Il est utilisé en interne et peut être invoqué via @general dans les messages.
En savoir plus sur les agents.
Pour plus d'informations sur la configuration d'OpenCode, consultez notre documentation.
Si vous souhaitez contribuer à OpenCode, lisez nos docs de contribution avant de soumettre une pull request.
Si vous travaillez sur un projet lié à OpenCode et que vous utilisez "opencode" dans le nom du projet (par exemple, "opencode-dashboard" ou "opencode-mobile"), ajoutez une note dans votre README pour préciser qu'il n'est pas construit par l'équipe OpenCode et qu'il n'est pas affilié à nous.
