Livepeer Agent

端末ファーストのLivepeerクライアント。決定論的CLIとネイティブエージェントを備えています。

LivepeerのID、アクセス、メール検証は https://agent.livepeer.org/api/mcp が管理します。CLIは1つのDaydream APIキーを提供し、製品認証やエンタイトルメントサービスは別途実装しません。

インストール

Node.js 22.19以降が必要です。GitHubアカウントなしで最新の公開リリースをインストールするには：

curl -fsSL https://raw.githubusercontent.com/peacenode/livepeer-agent-releases/main/install.sh | sh

インストーラーはリリースのチェックサムを検証し、~/.local/share/livepeer-agent にインストールし、両方のコマンドを ~/.local/bin にリンクします。そのディレクトリがまだ PATH にない場合は、シェルプロファイルに追加してください。

0.1.1 以降では、ターミナルからアップデートを確認するか、最新リリースをインストールできます：

livepeer update --check
livepeer update

0.1.0 ユーザーは、一度だけワンラインインストーラーを再実行することでアップデートできます。以降のリリースでは livepeer update が直接サポートされます。

ソース開発はこのリポジトリで行われます。安定リリースのアーティファクト、インストーラー、サードパーティ通知は peacenode/livepeer-agent-releases にミラーリングされます。SHA-256検証により、破損または不一致のダウンロードを検出します。ただし、チェックサムはアーカイブと同じ場所にホストされているため、配布リポジトリやそのメンテナが侵害された場合を独立して防ぐことはできません。

環境変数を使用して、リリースを固定したり、ユーザー所有の別のディレクトリを選択したりできます：

LIVEPEER_AGENT_VERSION=v0.1.0 \
LIVEPEER_AGENT_INSTALL_ROOT="$HOME/.livepeer-agent" \
LIVEPEER_AGENT_BIN_DIR="$HOME/bin" \
sh install.sh

ソースリリースは、v* タグをプッシュするか、v0.1.0 などのバージョンを指定してReleaseワークフローを実行することで、npmを使用せずにビルドされます。ワークフローは livepeer-agent.tgz とそのSHA-256チェックサムをアップロードする前に、完全な品質ゲートを実行します。メンテナは、./scripts/promote-release.sh v0.1.0 を使用して、それらの正確に検証されたファイルを安定配布リポジトリにミラーリングできます。

Related MCP server: MAGI Orchestrator

開発

Node.js 22.19以降とpnpm 10が必要です。

pnpm install
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm package:validate

テストスイートは実際のサービスに接続しません。

ローカル環境のオーバーライドは、無視される .env.local に属し、.env.example には絶対に記述しないでください。CLIは自動的にロードしません。値を必要とするコマンドに対してのみソースしてください：

set -a
. ./.env.local
set +a
livepeer agent

Daydreamキーには livepeer key add を推奨します。プレーンテキストのプロジェクトファイルではなく、プラットフォームの認証情報ストアを使用するためです。

CLI

スタンドアロンでインストール可能なパッケージをビルドして検証する：

pnpm build
pnpm package:validate

バリデーターはCLIをパッケージ化し、一時的なグローバルプレフィックスにインストールし、livepeer --help と livepeer-agent --help の両方を呼び出します。

非表示のプロンプトを通じてDaydreamキーを保存する：

livepeer key add
livepeer key status

一時的なローカルテストの場合は、プロセス環境を通じてキーを提供します。export DAYDREAM_API_KEY=... コマンドに値を直接記述することは避けてください。シェルは通常そのコマンドを履歴に保持するためです：

read -s DAYDREAM_API_KEY
export DAYDREAM_API_KEY
livepeer agent
unset DAYDREAM_API_KEY

キーは固定されたLivepeer MCPエンドポイントにのみ送信されます。保存されたキーは DAYDREAM_API_KEY より優先されます。LIVEPEER_MCP_URL がそのエンドポイントをオーバーライドする場合、CLIはどちらのキーも転送せずにフェイルクローズします。CLIは .env ファイルを自動的にロードしません。

メール検証は、現在のキーのMCPプロファイルに属します。エージェントで、「メールを確認してください」と依頼すると、me_update、request_activation、そしてワンタイムコードを入力した後の activate が呼び出されます。無関係なウェブサイトアカウントや別のAPIキーを検証しても、現在のキーは有効化されません。

アクセスパス

Livepeer Agentは、2つの明示的なMCP所有のパスをサポートします。

1. キーレスプレビュー: livepeer を実行し、「メールを確認してください」と指示します。MCPはメールフローを現在のキーレスプロファイルにアタッチし、プレビューアローワンスのみをアンロックします。

2. Daydreamモデル: livepeer key add を実行し、既に開いているエージェントを再起動し、次に livepeer access status を実行します。成功したステータスは credentialApplied: true と keyClass: "daydream" を報告します。エージェントで、制限付きアクションにMCPがメールプロファイルを必要とする場合は、「メールを確認してください」と指示します。

livepeer access status は安全なブール値と状態ラベルのみを報告します。APIキー、メールアドレス、プリンシパルIDは決して表示しません。キーレスプロファイルの追加と検証ではDaydreamモデルはアンロックされず、Daydreamキーの追加では別のMCPプリンシパルで以前に検証されたプロファイルは転送されません。

一般的なコマンド：

livepeer tools list
livepeer key add
livepeer key status
livepeer access status
livepeer capabilities list --kind ai --limit 10
livepeer tools call <name> --input request.json --yes
livepeer media generate --prompt "A quiet field at sunrise" --yes
livepeer jobs wait <job-id> --interval 2 --timeout 600
livepeer provider add openai
livepeer provider login openai-codex
livepeer browser install
livepeer agent

ブラウザ自動化

エージェントは、curl へのシェルアウトや生のHTMLのスクレイピングではなく、ネイティブでステートフルなブラウザツールを使用します。ツールは固定されたPlaywright CLIコンパニオンに支えられ、アクセシビリティスナップショットと要素参照で動作します。コンパニオンと管理対象のChromiumビルドを一度インストールします：

livepeer browser status
livepeer browser install

スタンドアロンCLIは小さく保たれ、通常のパッケージインストール中にChromiumをダウンロードすることはありません。管理対象ブラウザファイルはLivepeer設定ディレクトリの下に配置されます。読み取り専用のナビゲーションは自動です。データを送信したりウェブサイトを変更する可能性のある操作には、ターミナルでの承認が必要です。ログイン、SSO、2FAにはヘッド付きブラウザを使用し、ブラウザウィンドウに直接認証情報を入力してください。

モデルプロバイダーキーは、macOSキーチェーンに別々のOpenAIおよびAnthropicエントリとして保存されます。サポートされている認証情報ストレージがないシステムでは、CLIはプロバイダー固有のパーミッション 0600 のファイルを使用する前に警告を表示します。既存の providers.json キーは個別に移行され、安全な書き込みが成功した後、レガシーファイルから削除されます。

livepeer provider login openai-codex は、Piに組み込まれたChatGPT/Codex OAuthフローを使用します。OAuth認証情報と更新状態はユーザーのコンピューターのキーチェーンに残り、Livepeerのアクセス、トランスクリプト、モデルコンテキストには決して入りません。OpenAI APIキーへの直接アクセスは、livepeer provider add openai を通じて引き続き利用できます。

コントリビューションとセキュリティ

開発と検証の要件については CONTRIBUTING.md を参照してください。セキュリティの脆弱性は SECURITY.md の指示に従って非公開で報告してください。脆弱性や公開された認証情報が疑われる場合は、公開イシューを開かないでください。

Livepeer Agentは Apache License 2.0 の下でライセンスされています。所有するPiコーディングエージェントフォークは、上流の MITライセンス を保持します。バンドルされた依存関係の帰属は THIRD_PARTY_NOTICES.md に記録されています。