Repolode
Samin100

Samin100/codex-ios-assistant

iMessageとiOS Shortcutを介して、Mac上のCodexからiPhoneを操作・確認できるCLI。

スター
271
フォーク
35
未解決の Issue
1
最終コミット
2 か月前

これは何?

Codex iOS Assistantを使うと、Mac上で動作するCodexからiPhoneにコマンドを送信できます。`iphone` CLIがiMessage経由で非公開のコマンドを送り、iOS ShortcutがiPhone上で要求された操作を実行します。結果は、Cloudflare Tunnelで公開された認証済みHTTPSエンドポイントを通じてMacに返されます。

対応する操作には、画面に表示されているテキストの読み取りやスクリーンショットの保存、クリップボードの読み取りと置き換え、アラームの一覧表示と管理、一般的なiOSアプリの起動、タイマー・フラッシュライト・低電力モードの切り替え、電話の発信、Macの連絡先やメッセージデータベースの検索などがあります。メッセージの作成では確認用の下書きを開くだけで、CLIが通常のメッセージを送信したり、商品を購入したり、アプリをインストールしたり、配車を依頼したりすることはありません。

インストールにはmacOS 14以降を搭載したMac、Cloudflareで管理しているドメイン、ShortcutsのiCloud同期が必要です。Shortcutのオートメーショントリガーは、iPhoneのShortcutsアプリで手動で作成する必要があります。

主な機能

  • 01iPhoneの画面に表示されているテキストを読み取るか、スクリーンショットを保存します。
  • 02iPhoneのクリップボードを読み取り、内容を置き換えます。
  • 03アラームを一覧表示、作成、無効化します。
  • 04一般的なiOSアプリを起動し、タイマー、フラッシュライト、低電力モードを操作します。
  • 05Macの連絡先を検索し、Macのメッセージデータベースを読み取ります。
  • 06認証済みのCloudflare Tunnel経由で、iPhoneからの応答をMacに返します。

ユースケース

  • モバイルのフローをデバッグする際、iPhoneの画面に表示されている内容をCodexに確認させる。
  • 作業中にMacとiPhoneのクリップボード間でテキストをやり取りする。
  • Codexにリモートでアラームやタイマーの設定・確認を頼む。
  • Codexのセッション内からMacの連絡先や最近のメッセージを検索する。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/samin100/codex-ios-assistant.git
  2. 2

    プロジェクトフォルダーに移動する

    cd codex-ios-assistant
  3. 3

    Homebrewでcloudflaredとimsgをインストールする

    brew install cloudflared steipete/tap/imsg
  4. 4

    インストーラースクリプトを実行する

    ./scripts/install

使う前に知っておきたいこと

  • macOS 14以降を搭載したMacが必要です。
  • HTTPSトンネル用にCloudflareで管理されているドメインが必要です。
  • iPhoneのショートカットオートメーションは手動で作成する必要があり、ショートカットのiCloud同期も必要です。
  • Remoteワークフローには、ChatGPTのデスクトップアプリとモバイルアプリが必要です。

トピック

よくある質問

codex-ios-assistant とは?
iMessageとiOS Shortcutを介して、Mac上のCodexからiPhoneを操作・確認できるCLI。 Codex iOS Assistantを使うと、Mac上で動作するCodexからiPhoneにコマンドを送信できます。`iphone` CLIがiMessage経由で非公開のコマンドを送り、iOS ShortcutがiPhone上で要求された操作を実行します。結果は、Cloudflare Tunnelで公開された認証済みHTTPSエンドポイントを通じてMacに返されます。
codex-ios-assistant は無料で使えますか?ライセンスは?
codex-ios-assistant は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
codex-ios-assistant は今もメンテナンスされていますか?
半年以内に更新あり。codex-ios-assistant の最終コミットは 2026年8月7日 です。
codex-ios-assistant は何に使えますか?
モバイルのフローをデバッグする際、iPhoneの画面に表示されている内容をCodexに確認させる。 作業中にMacとiPhoneのクリップボード間でテキストをやり取りする。 Codexにリモートでアラームやタイマーの設定・確認を頼む。 Codexのセッション内からMacの連絡先や最近のメッセージを検索する。
codex-ios-assistant のインストール方法は?
リポジトリをクローンする: git clone https://github.com/samin100/codex-ios-assistant.git プロジェクトフォルダーに移動する: cd codex-ios-assistant Homebrewでcloudflaredとimsgをインストールする: brew install cloudflared steipete/tap/imsg インストーラースクリプトを実行する: ./scripts/install
codex-ios-assistant はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Samin100/codex-ios-assistant

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト