Skip to content

README.ja.md

Latest commit

 

History

History
167 lines (126 loc) · 9.76 KB

README.ja.md

File metadata and controls

167 lines (126 loc) · 9.76 KB
Raw

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

Android 版 opencode

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 の Web UI（WebView 内の loopback 経由）が動作します。PC も Termux もリモートサーバーも不要で、プロトコルの変更もありません。

私たちが upstream に追加したもの（それ以外はすべて upstream の opencode です）:

パス 内容
packages/android Android ホスト: Gradle プロジェクト、WebView Activity、内蔵サーバー、モバイル UI 調整
script/android 再現可能なビルド: build-apk.sh と、サーバー、ripgrep、git ランタイム、翻訳のスクリプト
docs/android 技術ドキュメント: ビルド、実行ポリシー、ネイティブ依存、upstream パッチ

変更する upstream ファイルは 5 つだけです（Android ビルドターゲットとランタイム互換性）。それぞれ理由を docs/android/UPSTREAM_PATCHES.md に記載しています。

仕組み: Activity が内蔵サーバーを起動し（libopencode.so serve --hostname=127.0.0.1）、WebView で http://127.0.0.1:<port>/ を読み込みます。ツールはアプリの nativeLibraryDir から実行されます: /system/bin/sh、同梱の git、rg、そして bun/node として公開される Bun ランタイム。

  • ダウンロード: releases（app-release.apk、arm64、Android 8.0+）
  • ビルド: ./script/android/build-apk.sh — docs/android/BUILD.md を参照
  • 初回起動: ファイルアクセスを許可（セッションは /sdcard/OpenCode/home に保存され、再インストール後も残ります）。次に 設定 → プロバイダー でプロバイダーを接続し、プロジェクト（~/workspace）を追加します
  • 動作する: サーバーと Web UI、セッション、差分とシンタックスハイライト付きの 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 でもOK
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS と Linux（推奨。常に最新）
brew install opencode              # macOS と Linux（公式 brew formula。更新頻度は低め）
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # どのOSでも
nix run nixpkgs#opencode           # または github:anomalyco/opencode で最新 dev ブランチ

Tip

インストール前に 0.1.x より古いバージョンを削除してください。

デスクトップアプリ (BETA)

OpenCode はデスクトップアプリとしても利用できます。releases page から直接ダウンロードするか、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 はこのフォークからビルドしたネイティブ APK として Android でも動作します。本物のサーバーと同じ Web UI を同梱し、セッション、プロバイダーキー、プロジェクトは /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 Specification に準拠したパス
  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

Agents

OpenCode には組み込みの Agent が2つあり、Tab キーで切り替えられます。

  • build - デフォルト。開発向けのフルアクセス Agent
  • plan - 分析とコード探索向けの読み取り専用 Agent
    • デフォルトでファイル編集を拒否
    • bash コマンド実行前に確認
    • 未知のコードベース探索や変更計画に最適

また、複雑な検索やマルチステップのタスク向けに general サブ Agent も含まれています。 内部的に使用されており、メッセージで @general と入力して呼び出せます。

agents の詳細はこちら。

ドキュメント

OpenCode の設定については ドキュメント を参照してください。

コントリビュート

OpenCode に貢献したい場合は、Pull Request を送る前に contributing docs を読んでください。

OpenCode の上に構築する

OpenCode に関連するプロジェクトで、名前に "opencode"（例: "opencode-dashboard" や "opencode-mobile"）を含める場合は、そのプロジェクトが OpenCode チームによって作られたものではなく、いかなる形でも関係がないことを README に明記してください。

コミュニティに参加 Discord | X.com