Copilot-Termux

GitHub Copilot CLI for Termux (Android aarch64).

Termux (Android aarch64) 向け GitHub Copilot CLI パッケージです。

Status / 状態

• @latest: 1.0.77（recommended / 推奨）
• package: @bash0816/copilot-termux
• copilot -p: available ✅（1.0.77、glibc mode）
• TUI (copilot): available ✅（1.0.77、glibc mode）
• MCP: available ✅（1.0.77、glibc mode）

既知の問題は Known Issues 参照。

Install / インストール

npm install -g @bash0816/copilot-termux
copilot-termux setup
copilot --version

First-time Setup / 初回セットアップ

# 1. Install
npm install -g @bash0816/copilot-termux

# 2. Download @github/copilot CLI
copilot-termux setup

# 3. Authenticate
copilot auth login

# 4. Verify
copilot --version

Usage / 使い方

# Non-interactive prompt / 非対話プロンプト
copilot -p "write a hello world script"

# Interactive TUI / 対話型 TUI
copilot

Update / 更新

npm install -g @bash0816/copilot-termux@latest --force
copilot-termux setup

Requirements / 必要環境

• Termux (Android aarch64)
• Node.js 18+（pkg install nodejs）
• glibc（pkg install glibc-repo && pkg install glibc）

How It Works / 仕組み

@bash0816/copilot-termux は @github/copilot CLI の Termux 向けラッパーです。

• bionic-compat.so: Termux bionic 上で動作しない glibc 依存シンボルをスタブ
• platform-patch.js: Rust ネイティブモジュールの Android 非対応 API を Node.js で代替
  • networkFetch*: MCP SSE transport 用 HTTP ストリーム実装
  • responsesStreamDrive: AI レスポンスストリーム処理
  • modelHttp*: AI モデル HTTP 呼び出し
• pty.node: Termux bionic ネイティブビルドの PTY モジュール

Known Issues / 既知の問題

• 1.0.75+: bionic フォールバック経路でクラッシュする既知の問題があります。 本パッケージは Requirements の glibc を正しくセットアップして使うことを前提としています。 glibc のセットアップが未完了/不十分な状態のまま実行すると bionic フォールバック経路に入り、 1.0.75 以降ではこの経路で copilot がクラッシュして起動できません。回避策: 上記 Requirements の通り pkg install glibc-repo && pkg install glibc を 実施し、glibc mode で実行してください（glibc mode では本問題は発生しません）。調査中です。

• 1.0.76のCAPI rename検知修正（BIONIC_SIGSEGV_STUB_GROUPS）により、以前は該当exportが見つからずfail-safeで早期停止していたbionicフォールバック経路が、この既知のSIGSEGVそのものへ到達するようになりました。これはrename修正自体の回帰ではありません。

Do Not Use / 非推奨

@github/copilot を Termux に直接インストールしないでください。bionic 非互換で動作しません。

License / ライセンス

• Wrapper code (packages/copilot-termux/): GPL-3.0-only
• @github/copilot CLI: GitHub Copilot CLI License（独自ライセンス・再配布条件あり）
• PTY module (pty.node): MIT