@bash0816/agy-termux

Google Antigravity CLI (agy) for Termux on Android ARM64.

Termux 向け Google Antigravity CLI (agy) wrapper package です。

This project is not affiliated with, endorsed by, or sponsored by Google. このプロジェクトは Google と無関係です。Google から承認・提携・保証されたものではありません。

⚠️ Notice: Terms of Service risk / 利用規約リスクについて

Google Antigravity's terms of service state that accessing Antigravity via third-party software, tools, or services is a violation. There have been confirmed cases in early 2026 of paid Antigravity/Gemini subscribers being suspended for using third-party tools such as OpenClaw and OpenCode.

agy-termux is a thin, standalone wrapper that runs a single official Google-distributed binary on Termux/Android — it does not integrate or bridge multiple third-party AI CLIs the way OpenClaw/OpenCode do. Based on this structural difference, the maintainer has decided to continue this project for the time being (as of 2026-07-23), while acknowledging that the underlying ToS risk has not disappeared. Use at your own risk.

Google Antigravity の利用規約には、サードパーティのソフトウェア・ツール・サービス経由での アクセスが規約違反である旨が明記されています。2026年初頭、有料 Antigravity/Gemini サブスクリプションユーザーが OpenClaw・OpenCode 等のサードパーティツール利用を理由に アカウント停止された事例が確認されています。

agy-termux は、Google 公式配布の単一バイナリを Termux/Android 上で動作させるだけの 薄い単体ラッパーであり、OpenClaw/OpenCode のように複数のサードパーティ AI CLI を横断統合 するものではありません。この構造的な違いを踏まえ、開発者は本プロジェクトを当面継続する ことを決定しました（2026-07-23時点）。ただし上記の利用規約リスク自体が消えたわけではありません。 利用は自己責任でお願いします。

What this does / 仕組み

This package downloads the official agy binary from Google's public release source (google-antigravity/antigravity-cli) at the user's explicit request and applies a local compatibility adjustment on your device to enable execution in the Termux/Android ARM64 environment.

このパッケージはユーザーの明示的な操作により、Google の公開 Release (google-antigravity/antigravity-cli) から公式バイナリをダウンロードし、Termux/Android ARM64 で動作させるための ローカル互換性調整をユーザー端末上で行います。

• No Google binaries or modified binaries are distributed by this package.
• このパッケージは Google バイナリや改変済みバイナリを配布しません。
• The adjustment is intended solely for Termux/Android runtime interoperability. It does not bypass authentication, licensing, payment, access controls, or usage restrictions.
• 調整の目的は Termux/Android 実行環境への互換性確保のみです。 認証・ライセンス・課金・アクセス制御・利用制限の回避を意図するものではありません。

Prerequisites / 前提条件

pkg install glibc-repo && pkg install glibc

Install / インストール

npm install -g @bash0816/agy-termux

On first run, you will be prompted to confirm:

1. Downloading the official agy binary from Google's public release.
2. Applying a local compatibility adjustment for this device.

Both steps are skipped on subsequent runs if the version has not changed.

初回起動時に以下を確認するプロンプトが表示されます:

1. Google 公式 Release から公式バイナリをダウンロードすること。
2. このデバイスへのローカル互換性調整を適用すること。

バージョンが変わっていない場合、2回目以降は両ステップをスキップします。

Tested with agy 1.1.9 on Android 12+ (SIGSYS shim + version pin).

agy 1.1.9・Android 12+ で動作確認済み（SIGSYS shim + version pin）。

Update / 更新

npm update -g @bash0816/agy-termux

This package downloads a specific verified version of the agy binary pinned in config/agy-verified-versions.json, ensuring compatibility with the SIGSYS workaround. To force download the latest upstream version instead, set AGY_TERMUX_FORCE_LATEST=1 (not recommended; compatibility not guaranteed). Note: When AGY_TERMUX_FORCE_LATEST=1 is set, the output of --version does not reflect the actual upstream version being used — it always displays the wrapper package version as configured in package.json.

agy update compares the installed wrapper package version against the npm registry's latest tag and reinstalls only if a newer version is available. It does not distinguish published builds from local test builds. If you are running a local test build and want to force-reinstall the published latest version regardless of version numbers, run npm install -g @bash0816/agy-termux@latest manually.

このパッケージは config/agy-verified-versions.json に固定された検証済みバージョンをダウンロードします。SIGSYS対応の互換性が保証されます。 最新 upstream バージョンを試す場合は AGY_TERMUX_FORCE_LATEST=1 を設定してください（非推奨。互換性の保証なし）。 注記: AGY_TERMUX_FORCE_LATEST=1 が設定されている場合、--version の表示は実際に取得される upstream バージョンを反映しません — 常に package.json で定義されたラッパーパッケージバージョンを表示します。

agy update は、インストール済みのラッパーパッケージバージョンと npm registry の latest タグを比較し、新しいバージョンがある場合のみ再インストールします。公開版・ローカルテストビルドの区別はしません。ローカルテストビルドを使用中で、バージョン番号によらず公開済みの latest へ強制的に戻したい場合は、npm install -g @bash0816/agy-termux@latest を手動で実行してください。

Usage / 使い方

agy [command] [options]

For available commands, see the Antigravity CLI documentation.

利用可能なコマンドは Antigravity CLI ドキュメント を参照してください。

Version and Caching / バージョンとキャッシュ

Version check: agy --version (or -v, -V, version) prints the wrapper package version in a single line without triggering any network access, consent prompts, or binary downloads.

バージョン確認: agy --version (または -v, -V, version) はラッパーパッケージバージョンを1行で表示します。ネットワーク接続・同意プロンプト・バイナリダウンロードは一切発生しません。

Caching: The downloaded binary is persisted locally at ~/.agy-termux/agy.va39 (patch-needed devices) or ~/.agy-termux/.bin (other devices). Devices that don't need the VA39 patch now benefit from persistent caching — the binary is only re-downloaded if the upstream version changes or becomes corrupted.

キャッシング: ダウンロード済みバイナリは ~/.agy-termux/agy.va39（パッチが必要なデバイス）または ~/.agy-termux/.bin（その他のデバイス）にローカル保持されます。VA39 パッチが不要なデバイスも永続的なキャッシュの恩恵を受けるようになりました — バイナリは upstream バージョンの変更や破損時にのみ再ダウンロードされます。

Force refresh: Set AGY_TERMUX_REFRESH=1 to force a clean re-download and re-verification of the binary, even if the cached version matches the upstream tag.

AGY_TERMUX_REFRESH=1 agy [command]

強制リフレッシュ: AGY_TERMUX_REFRESH=1 を設定することで、キャッシュされたバージョンが upstream タグと一致していても、強制的にバイナリの再ダウンロード・再検証を行います。

License / ライセンス

This package (agy-termux) is licensed under GPL-3.0-only.

このパッケージ (agy-termux) は GPL-3.0-only ライセンスです。

The GPL does not apply to the agy binary. The agy binary downloaded at runtime is the property of Google LLC and is subject to Google's terms of service. This package does not grant any rights to Google's binary.

GPL は agy バイナリには適用されません。 実行時にダウンロードされる agy バイナリは Google LLC の著作物であり、Google の利用規約に従います。 このパッケージは Google バイナリに対する権利を付与しません。

See NOTICE.md for third-party attribution.

サードパーティ帰属については NOTICE.md を参照してください。

Disclaimer / 免責事項

Users are responsible for ensuring that their use of Google Antigravity CLI complies with Google's terms of service and applicable laws.

Google Antigravity CLI の利用条件・適用法令への適合性はユーザー自身が確認してください。 Google の利用規約 を参照してください。

If a rights holder or platform operator raises a substantiated concern regarding this package, we will promptly review it and may remove or disable the affected functionality.

権利者またはプラットフォーム運営者から具体的な懸念が示された場合、 内容を確認し、必要に応じて公開停止・機能停止・修正を行います。

Compatibility / 動作環境

• Platform / プラットフォーム: Android (Termux)
• Architecture / アーキテクチャ: ARM64 (aarch64)

Known limitations / 既知の制限

• Upstream agy updates may require a compatibility update to this package. 上流 agy のアップデートにより本パッケージの更新が必要になる場合があります。
• If the downloaded binary fails validation, the tool will exit safely. ダウンロードしたバイナリが検証に失敗した場合、安全に終了します。
• Google may change their release distribution or terms at any time. Google はリリース配布方法や利用規約をいつでも変更する可能性があります。

Rollback / ロールバック手順

If a critical issue is discovered after promoting a new version to latest, you can immediately roll back to the previous version using the following command:

新バージョン昇格後に重大な問題が発見された場合、以下のコマンドで前バージョンにロールバックできます:

npm dist-tag add @bash0816/agy-termux@<previous known-good version> latest

This reverts the latest tag to a previous known-good version and will restore the previous stable release for all new installations and updates.

これにより latest タグを前のステーブル版に戻し、新規インストール・更新時に前のステーブル版を配布します。