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 向けのデスクトップアプリ、そして app.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 because Cursor Agent CLI does not consume MCP directly, Happier hands the same tool surface to it through the happier tools shell bridge instead — the same tools, delivered as commands it can run. The app previews the effective tool surface before a session starts, so which one you got is visible rather than inferred.

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

ターミナルで 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 ライセンスで、リレーは自分で動かせるものです。