Ramus Android

Ramus android-use

Ramus を活用した、コーディングエージェント向けの Android-use です。Claude Code、Codex、Cursor、Gemini CLI、またはシェルを使える任意のエージェントに、操作可能な使い捨てのクラウド Android エミュレーターを提供します。画面の確認、タップ、文字入力、スクリーンショットの撮影、ログの読み取りができ、ブラウザーから操作を見たり、引き継いだりできます。

このプラグインは、Ramus のホステッドサービスに接続します。Ramus アカウント（アルファ期間中は無料）または 60 分間の CLI トライアルが必要です。

インストール

Claude Code の場合、プラグインとしてインストールします（android-use スキルと Ramus MCP サーバーが含まれます。任意の API キーを求められます）。

/plugin marketplace add ramus-dev/android-use
/plugin install ramus@ramus

Cursor、Codex、GitHub Copilot、Kiro、およびその他の Agent Plugins クライアントの場合：このリポジトリをプラグインとしてインストールします（ルートにある plugin.json）。

スキルに対応する任意のエージェントの場合は、skills CLI を使用します。

npx skills add ramus-dev/android-use

Claude Code で手動でインストールする場合：skills/android-use/SKILL.md を .claude/skills/android-use/SKILL.md にコピーします。

Gemini CLI の場合、拡張機能としてインストールします（スキルと Ramus MCP サーバーが含まれます）。

gemini extensions install https://github.com/ramus-dev/android-use

任意の MCP クライアント（Cline、Claude Desktop、Cursor、Windsurf、VS Code）の場合、リモートサーバーとして接続します。Streamable HTTP を使用するため、ローカルプロセスは不要です。

{
  "mcpServers": {
    "ramus": {
      "url": "https://api.ramus.dev/api/mcp",
      "headers": { "Authorization": "Bearer <RAMUS_API_KEY>" }
    }
  }
}

キーは https://ramus.dev/settings で作成します。サーバーは android_* ツールを公開します（デモアプリまたはプルリクエストからセッションを開始する、UI ツリーのスナップショットを取得する、タップする、文字を入力する、キーを押す、待機する、スクリーンショットを撮る、ログを確認する、共有する）。tools/list で一覧を確認できます。ローカル APK のアップロードと開発ループには、以下の CLI が必要です。

トライアルにはアカウントは不要です。

npx ramus-cli trial
npx ramus-cli session start --apk app-debug.apk --wait

ChatGPT と Codex（OpenAI プラグイン）

このリポジトリは OpenAI プラグインパッケージも兼ねています。plugin.json の extensions.com.openai にディレクトリの掲載情報が含まれ、mcp.json はリモート MCP サーバーを参照します（ユーザーは Ramus にサインインして接続するため、API キーは不要です）。また、スキルは skills/*/agents/openai.yaml で実行環境を宣言します。 OpenAI パッケージに含まれるのは android-mcp のみです（MCP ツール、ChatGPT、Codex）。android-use はシェル経由で CLI を操作しますが、OpenAI のスキルスキャンで警告されるため、scripts/package-openai.py では除外されます。

OpenAI プラグインポータル向けのアップロードをビルドします（「With MCP」経由）。

python3 scripts/package-openai.py   # validates, then writes dist/ramus-openai-plugin.zip

このスクリプトは、掲載情報が OpenAI の制限に適合するか確認し、他のクライアント向けのファイルを除外します。

仕組み

デバイスは、Ramus のフリート上で標準の Google イメージを実行する実機の Android エミュレーターで、WebRTC 経由でストリーミングされます。このスキルは、観察、操作、検証を繰り返すループをエージェントに教えます。UI ツリーのスナップショットを読み取り、参照先の要素を操作してから、次に進む前に結果を確認します。

リンク

• ドキュメント：https://ramus.dev/docs/agents

• エージェントリファレンス：https://ramus.dev/agents.md

• MCP エンドポイント（Streamable HTTP、API キー）：https://api.ramus.dev/api/mcp

• npm の CLI：https://www.npmjs.com/package/ramus-cli

• プライバシーポリシー：https://ramus.dev/privacy

• 利用規約：https://ramus.dev/terms

• 許容される使用：https://ramus.dev/acceptable-use

• サポート：[email protected] · セキュリティ：[email protected]

Android 専用です。アルファ期間中は無料です。ご自身で作成したアプリ、またはテストの許可を得たアプリのテストにご利用ください。

SKILL.md は Ramus の製品仕様から生成されます。正式版は https://ramus.dev/skill.md で提供されています。