Cursor Agent CLI をスマートフォンから動かす

Cursor について何よりも先に知っておくべきなのは、対象のバイナリがエディター用にインストールしたものではないということです。Happier が探すのはヘッドレス CLI の cursor-agent であり、cursor は意図的に探しません。たいていのコンピューターで cursor はエディターウィンドウを開くもので、誰も座っていないコンピューターでは役に立たないからです。Cursor 自身の CLI ドキュメントはコマンドを agent と書いているため、Happier はその名前のバイナリも受け付けますが、それは about --format json を尋ねて Cursor のバージョンが返ってきた後だけです。PATH にたまたまある agent が、事故であなたのコーディングエージェントになることはありません。

Anysphere はこの CLI を「ターミナルから直接 AI エージェントとやり取りして、コードを書き、レビューし、変更する」手段だと説明し、対話的なインターフェースと、スクリプトや CI パイプライン向けの print による自動化を同じ位置づけに置いています。この後半こそがこのページの存在理由です。誰も見ていなくても問題なく動くからこそ、どこから読むのかが現実の問いになります。Happier は、そのコンピューターで Cursor がサインインしているかどうかについても、肩をすくめずに答えられます。同じ about 呼び出しがアカウントを報告し、環境に CURSOR_API_KEY があれば、そういう構成のマシンではそれが尊重されます。

Cursor の二つの挙動には、Happier 側で個別の対応が必要でした。一つは画像の生成で、生成された画像は自分で探しに行くファイルパスではなく、セッションメディアとしてトランスクリプトに届きます。もう一つは構造化された質問で、選択肢、複数選択、自由記述欄を伴います。アプリはこれを、散文で答えなければならない大量のテキストではなく、質問として描画します。プランのステップも、承認するか差し戻すかできるプランとして届きます。モデルの選択はあなた自身の CLI から読み取られ、バリアントを提示するモデルは、推論の強度を選ぶコントロールと fast トグルを備えた一つの項目として現れます。Happier が意図的に悲観的なのは再開だけです。このリリースでは実験的と明示され、提示する前に手元のバイナリに照らして確認され、失敗した再開は失敗として扱われます。古いタイトルのまま黙って新しい会話を開くことはありません。

Cursor のコマンドラインエージェントは、エディターとは別のバイナリ cursor-agent です。ターミナルからリポジトリを操作するため、GUI のないマシンでも問題なく動きます。happier cursor は、あなた自身の Cursor アカウントでそれを起動します。

ここに来た理由が「Cursor に課金しているが、デスクにいない」であれば、それがこの機能のすべてです。エージェントはリポジトリのある場所で動き、あなたは手元のどのデバイスからでも、それを読み、承認し、方向づけます。

iOS と Android のアプリ、macOS・Windows・Linux 向けのデスクトップアプリ、そして cloud.happier.dev は、いずれもあなたのコンピュータで動いている Cursor Agent CLI のプロセスへのクライアントであって、読み取り専用のミラーではありません。権限リクエストに答え、次の指示を送り、リポジトリを閲覧し、差分を読めます。トランスクリプトはコンピュータを離れる前にエンドツーエンドで暗号化されるので、それを運ぶサーバーが持つのは暗号文です。

Happier はすでにリポジトリを持っているコンピュータにインストールされ、happier cursor が、あなたの指定したディレクトリで、あなたがサインインしたままの状態で、Cursor Agent CLI を通常のサブプロセスとしてそこで起動します。エージェントと Anysphere の間にゲートウェイはなく、ソースのコピーがどこか他の場所にあることもありません。

Happier は PATH 上の cursor-agent を探し、あなたがインストールしたものを実行します。Anysphere はこれをパッケージではなくインストールスクリプトで配布しています。Happier はそのコマンドを表示できますが、ベンダーのインストールスクリプトを自分で実行することはありません — ベンダーのレシピは、明示的に許可しない限り拒否されます。

Anysphere 自身のインストールとサインインのガイドは cursor.com/docs/cli/installation にあります。Happier はそれを複製しません。他社のインストール手順の写しは、古くなる写しだからです。

Cursor Agent CLI は Happier が動かす 13 のコマンドラインのコーディングエージェントの 1 つで、それらは 1 つのセッションリスト、1 つの権限の受信トレイ、1 組のキーボードショートカット、1 つの MCP 設定を共有します。

You define an MCP server once and Cursor Agent CLI receives it as native MCP inventory, next to whatever MCP servers it already had of its own.

それが一番効くのは、複数を同時に動かしている日です。異なるベンダーのセッションが並び、通知をタップするとアプリの入口ではなく、そのリクエストを出したセッションが開きます。全リストはこちら。

ターミナルで happier cursor と打てば、いま立っているその場所でセッションが始まり、同じセッションが同時にアプリの中にもあります。そのシェルで読むのは Cursor Agent CLI のインターフェースではなく、Happier 自身によるセッションの表示 — トランスクリプト、権限の確認、ツールの出力 — です。携帯電話のクライアントを得るためにターミナルを手放す必要は、誰にもありません。

Cursor Agent CLI 本来の TUI への受け渡しはありません。それがあるのは Claude Code、Codex、OpenCode で、Cursor Agent CLI の場合はセッションが両端とも Happier のものになります。happier attach <session-id> はそのコンピューター上のセッションを一覧し、再接続できないものに印を付けます。選んだあとで失敗させることはありません。

attach ガイドは、すべてを約束する代わりに、対応するケースを列挙しています。

コードを持っているコンピュータでコマンドを 1 つ、そのあと作業したいリポジトリで happier cursor です。

手順の解説はガイドにあります。すべて MIT ライセンスで、リレーは自分で動かせるものです。