Repolode
nikships

nikships/muse-cli

個人用muse.aiエージェントとターミナルからチャットしたり、サイドチャット、フィード、目標、アイデア、セッションを扱ったりできるCLIクライアント。

スター
51
フォーク
20
未解決の Issue
1
最終コミット
13 時間前

これは何?

muse-cliを使えば、ブラウザーを開かずに個人用のmuse.aiエージェントとやり取りできます。名前付きサブコマンドでチャット、サイドチャット、フィード、目標、アイデア、セッション管理を行えるほか、rawコマンドから258種類のゲートウェイメソッドすべてにアクセスできます。各コマンドはJSONを出力するため、jqやcronジョブ、ほかのスクリプトに渡して利用できます。

接続方式はmuse.aiのWebアプリと同じです。HTTPSで認証したあと、暗号化されたNoise-XX WebSocketを使ってユーザー個人のVMに接続します。ログインにはGoogle ChromeのCookieを再利用します。Cookieはagent-browserヘルパーで一度エクスポートし、制限付きのファイル権限でローカルに保存します。アクセストークンはコマンドを実行するたびに新たに取得されます。

このプロジェクトはPythonで書かれており、uv、pipx、pipでインストールできます。また、コーディングエージェントがユーザーに代わって読み取り専用のmuse-cliコマンドを実行できるよう、agent skillも付属しています。内部APIにはバージョンが付いていないため、muse.aiの変更によって呼び出しが動作しなくなる可能性があるとプロジェクトでは説明しています。

主な機能

  • 01エージェントとチャットし、返信をシェルからJSONとして読み取れます。
  • 02サイドチャットの一覧表示、名前変更、ピン留め、アーカイブ、セッション削除ができます。
  • 03フィードの閲覧やリアクション、目標やアイデアの確認ができます。
  • 04258種類のゲートウェイメソッドすべてに対応するrawコマンドを利用できます。
  • 05ChromeのCookieを再利用して認証し、mode 600でローカルに保存します。
  • 06agent skillが付属しており、コーディングエージェントにコマンド実行を任せられます。

ユースケース

  • エージェントの返信をシェルスクリプトやjqのパイプラインに渡す。
  • cronでエージェントへの定期的な問い合わせをスケジュールする。
  • コーディングエージェントに、ターミナルから自分のステータスや目標を確認させる。
  • ターミナルベース、またはスクリーンリーダーで使いやすいチャットインターフェースとして利用する。

クイックスタート

  1. 1

    uv で CLI をインストールする

    uv tool install muse-cli
  2. 2

    npm から cookie reader をインストールする(Node.js が必要)

    npm i -g agent-browser
  3. 3

    Chrome でリモートデバッグを有効にし、muse.ai にログインしてからログイン情報を保存する

  4. 4

    接続を確認する

    muse-cli status

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

  • Google Chrome から取得したブラウザー Cookie と、変更される可能性のあるバージョン管理されていない muse.ai の内部 API に依存します。
  • muse.ai アカウントと個人用 VM が必要です。Cookie は有効期限が切れるため、ログイン手順を繰り返す必要があります。
  • 最も簡単なログイン方法を使うには、Chrome のリモートデバッグ設定と agent-browser が必要です。

トピック

よくある質問

muse-cli とは?
個人用muse.aiエージェントとターミナルからチャットしたり、サイドチャット、フィード、目標、アイデア、セッションを扱ったりできるCLIクライアント。 muse-cliを使えば、ブラウザーを開かずに個人用のmuse.aiエージェントとやり取りできます。名前付きサブコマンドでチャット、サイドチャット、フィード、目標、アイデア、セッション管理を行えるほか、rawコマンドから258種類のゲートウェイメソッドすべてにアクセスできます。各コマンドはJSONを出力するため、jqやcronジョブ、ほかのスクリプトに渡して利用できます。
muse-cli は無料で使えますか?ライセンスは?
muse-cli は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
muse-cli は今もメンテナンスされていますか?
活発にメンテナンス中。muse-cli の最終コミットは 2026年10月22日 です。
muse-cli は何に使えますか?
エージェントの返信をシェルスクリプトやjqのパイプラインに渡す。 cronでエージェントへの定期的な問い合わせをスケジュールする。 コーディングエージェントに、ターミナルから自分のステータスや目標を確認させる。 ターミナルベース、またはスクリーンリーダーで使いやすいチャットインターフェースとして利用する。
muse-cli のインストール方法は?
uv で CLI をインストールする: uv tool install muse-cli npm から cookie reader をインストールする(Node.js が必要): npm i -g agent-browser Chrome でリモートデバッグを有効にし、muse.ai にログインしてからログイン情報を保存する 接続を確認する: muse-cli status
muse-cli はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/nikships/muse-cli

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

関連プロジェクト