Skip to content

Latest commit

 

History

History
168 lines (127 loc) · 11.1 KB

File metadata and controls

168 lines (127 loc) · 11.1 KB

OpenCode logo

AI-агент для програмування з відкритим кодом.

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 для 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.

Цей форк запускає наявний opencode нативно на Android: на телефоні працюють справжній сервер, агент, сесії та незмінений веб-інтерфейс packages/app (через loopback у WebView). Без ПК, Termux, віддаленого сервера та змін протоколу.

Що додали ми (усе інше — upstream opencode):

Шлях Що це
packages/android Android-хост: Gradle-проєкт, WebView-активність, вбудований сервер, адаптація мобільного UI
script/android Відтворювана збірка: build-apk.sh та скрипти для сервера, ripgrep, git-рантайму й перекладів
docs/android Інженерні документи: збірка, політика виконання, нативні залежності, патчі upstream

Змінено лише п'ять файлів upstream (ціль збірки під Android і сумісність рантайму); кожен описано з причиною в docs/android/UPSTREAM_PATCHES.md.

Як це працює: активність запускає вбудований сервер (libopencode.so serve --hostname=127.0.0.1) і завантажує http://127.0.0.1:<port>/ у WebView. Інструменти запускаються з nativeLibraryDir: /system/bin/sh, вбудовані git, rg і рантайм Bun як bun/node.

  • Завантажити: releases (app-release.apk, arm64, Android 8.0+)
  • Збірка: ./script/android/build-apk.sh — див. docs/android/BUILD.md
  • Перший запуск: надайте доступ до файлів (сесії зберігаються в /sdcard/OpenCode/home і переживають перевстановлення), далі Налаштування → Провайдери → підключіть провайдера й додайте проєкт (~/workspace)
  • Працює: сервер і веб-інтерфейс, сесії, git з діфами й підсвічуванням (Changes), браузер файлів (Files), панель використання контексту (Usage), виконання команд і JS/TS
  • Обмеження: немає PTY-термінала, LSP і форматерів, локальних MCP-процесів; нативний file watcher недоступний (пошук через rg)
  • Ліцензія: MIT, як в оригіналі

OpenCode Terminal UI


Встановлення

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

# Менеджери пакетів
npm i -g opencode-ai@latest        # або bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS і Linux (рекомендовано, завжди актуально)
brew install opencode              # macOS і Linux (офіційна формула Homebrew, оновлюється рідше)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # Будь-яка ОС
nix run nixpkgs#opencode           # або github:anomalyco/opencode для найновішої dev-гілки

Tip

Перед встановленням видаліть версії старші за 0.1.x.

Десктопний застосунок (BETA)

OpenCode також доступний як десктопний застосунок. Завантажуйте напряму зі сторінки релізів або opencode.ai/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 або AppImage

Мобільний застосунок (BETA)

OpenCode також працює на Android як нативна APK, зібрана з цього форку. Застосунок містить справжній сервер і той самий веб-інтерфейс; сесії, ключі провайдерів і проєкти зберігаються в /sdcard/OpenCode/home і переживають перевстановлення.

Платформа Завантаження Примітки
Android 8.0+ (arm64) app-release.apk BETA — надайте доступ до файлів при першому запуску
Збірка з джерел ./script/android/build-apk.sh див. packages/android/README.md
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

Каталог встановлення

Скрипт встановлення дотримується такого порядку пріоритету для шляху встановлення:

  1. $OPENCODE_INSTALL_DIR - Користувацький каталог встановлення
  2. $XDG_BIN_DIR - Шлях, сумісний зі специфікацією XDG Base Directory
  3. $HOME/bin - Стандартний каталог користувацьких бінарників (якщо існує або його можна створити)
  4. $HOME/.opencode/bin - Резервний варіант за замовчуванням
# Приклади
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

Агенти

OpenCode містить два вбудовані агенти, між якими можна перемикатися клавішею Tab.

  • build - Агент за замовчуванням із повним доступом для завдань розробки
  • plan - Агент лише для читання для аналізу та дослідження коду
    • За замовчуванням забороняє редагування файлів
    • Запитує дозвіл перед запуском bash-команд
    • Ідеально підходить для дослідження незнайомих кодових баз або планування змін

Також доступний допоміжний агент general для складного пошуку та багатокрокових завдань. Він використовується всередині системи й може бути викликаний у повідомленнях через @general.

Дізнайтеся більше про agents.

Документація

Щоб дізнатися більше про налаштування OpenCode, перейдіть до нашої документації.

Внесок

Якщо ви хочете зробити внесок в OpenCode, будь ласка, прочитайте нашу документацію для контриб'юторів перед надсиланням pull request.

Проєкти на базі OpenCode

Якщо ви працюєте над проєктом, пов'язаним з OpenCode, і використовуєте "opencode" у назві, наприклад "opencode-dashboard" або "opencode-mobile", додайте примітку до свого README. Уточніть, що цей проєкт не створений командою OpenCode і жодним чином не афілійований із нами.


Приєднуйтеся до нашої спільноти Discord | X.com