lasso

エージェントとしての lasso の使い方

lasso は 1 台のマシンで動作し、エージェント群を取りまとめます。人間向けの herdr 上のブラウザー UI と、あなた向けの MCP サーバーを提供します。これを通じて、アクセス可能な任意のホスト上に別のコーディングエージェントを作成したり、エージェント（自分自身も含む）を見つけて終了したり、人間に通知したり、ファイルを提示したり、人間がライブで確認できる実際の Chromium を操作したりできます。

ドキュメント全文は、このリポジトリの docs/ にあります。docs/index.md からご覧ください。ツールのリファレンスは docs/mcp/tools.md です。

接続方法

通常、lasso connect によって登録される MCP サーバーは 2 つあります。

サーバー	URL	用途
lasso	<lasso>/mcp	エージェント、ホスト、notify、open_file、ブラウザープロファイルとタブ
lasso-browser	<lasso>/browser-mcp	共有ブラウザーに対する chrome-devtools-mcp のツール（移動、クリック、入力、スクリーンショット、コンソール、ネットワーク）

ツールが見つからない場合は、claude mcp list（またはお使いの CLI に相当するコマンド）を確認し、人間に lasso connect の実行を依頼してください。すべての MCP ツールにはシェル版もあります。lasso mcp で一覧を表示し、lasso mcp <tool> -h でフラグを確認できます。また、lasso notify、lasso open、lasso closeme はよく使うツールのショートカットです。

重要なルール

• lasso はエージェントと会話しません。 エージェントの作成、一覧表示、確認、終了を行います。別のエージェントにプロンプトを送信したり、その画面を読んだり、応答を待ったりするには、herdr（herdr agent prompt / read / wait）またはハーネス独自のエージェント間メッセージ機能を使ってください。
• $HERDR_PANE_ID は自分で渡す必要があります。 MCP サーバーは lasso のプロセス内で動作するため、あなたの環境変数を参照できません。whoami、notify、open_file、close_agent の pane_id として渡してください。
• host のデフォルトは lasso のホストではなく、自分のホストです。 別のマシンで操作するときにのみホストを指定してください。また、list_hosts の結果に表示されるホストに限ります。
• 一覧が空でも、たいていは障害ではなくスコープの制限です。 認証情報によって、表示できるホストが制限されます。
• lasso エージェントは close_agent（または lasso closeme）で終了してください。herdr pane close は使わないでください。 ペインを直接閉じると、エージェントの記録とステージング済みのプロンプトファイルが残ります。

エージェントの作成

1. list_hosts でホストを選びます（自分のホストを使う場合は host を省略します）。状態が probing または timeout の項目は停止しているわけではありません。少し待って再度呼び出すか、refresh: true を渡してください。
2. Git エージェントの場合は、list_repos でリポジトリのパスを、list_branches でベースブランチを選びます。
3. create_agent を呼び出します。
   • type：git（base_branch から分岐した新しいブランチ上に新しいワークツリーを作成します。デフォルトはリポジトリの HEAD です）または scratch（空のワークスペースです）。
   • agent：claude（デフォルト）、codex、opencode、omp、または pi。model、effort、extra_args は任意です。
   • prompt：最初のタスクです。省略すると、CLI は人間向けにアイドル状態で起動します。
   • title、branch_name、branch_prefix、notes（作業ディレクトリの NOTES.md に書き込まれます）、plan_mode（claude、opencode、omp）、advisor（omp）。
   • focus: true を指定すると、人間の表示が新しいペインに切り替わります。デフォルトでは表示位置は変わりません。

エージェントの id、ワークスペース、ルートペインがすぐに返され、エージェントは非同期で起動します。get_agent で状況を確認してください（ステータス：working、idle、blocked、unknown、または failed）。list_agents には、lasso が作成していない外部の herdr セッションも表示されます。そうしたセッションは sidebar_name または root_pane で指定してください。

多数のリポジトリを最新の状態にするには、リポジトリごとに create_agent を 1 回呼び出してください。

作業を終えて自分を終了する

lasso closeme                 # close the calling agent (uses $HERDR_PANE_ID)

MCP を使う場合は、pane_id に自分の $HERDR_PANE_ID を設定して close_agent を呼び出すか、先に whoami を呼び出し、返された id と host を指定して close_agent を呼び出してください。remove_worktree: true を指定すると、Git エージェントのワークツリーも削除され、コミットしていない作業は破棄されます。そのため、作業をコミットまたはプッシュした後にのみ使用してください。

人間に連絡する

notify は、画面がロックされていても相手のスマートフォンに通知を送ります。相手の対応が必要な場合にのみ使用してください。相手にしかできない判断を仰ぐとき、作業を止める質問があるとき、または相手が不在の間に時間のかかる処理が完了したときなどです。呼び出し回数に制限はないため、呼び出すたびに通知音が鳴ります。

lasso notify "the migration drops 2 columns. Safe to run on prod?"

結果を確認してください。sent: false（または CLI の終了コードが 0 以外）の場合、デバイスが登録されていないため、通知は届いていません。通知したと伝えないでください。

open_file は、すべての表示中の lasso タブで、ターミナルの隣にある Files パネルにファイルを表示します。「開いて見せて」と言われたときや、相手に何かを確認してもらいたいときに使用してください。絶対パスまたは ~/ から始まるパスを渡します（相対パスは CLI が解決します）。line は任意です。ディレクトリを指定すると、その場所のファイルツリーが開きます。delivered を確認してください。0 の場合、lasso タブが開いていないため、相手はファイルを見ていません。

lasso open docs/plan.md -line 40

ステータスカード。 herdr のサイドバーと lasso のペイン切り替え画面にある自分のペインのカードに、作業内容を1行で要約して表示し、フェーズが変わったら更新してください。

herdr pane report-metadata "$HERDR_PANE_ID" --source agent:self --token summary="<what you're doing>" --ttl-ms 1800000

herdr pane report-agent は使用しないでください。herdr 独自のステータス検出が上書きされます。

共有ブラウザー

lasso のマシン上で動作する実際の Chromium です。人間は lasso の Browser タブから表示して、クリック操作できます。

• shared_browser を呼び出すと、ブラウザーが起動し、/browser-mcp の URL（mcp_endpoint）、生の CDP WebSocket（Playwright の connectOverCDP 用の ws_endpoint）、すべてのプロファイルとそれぞれの CDP WebSocket を一覧表示する通常の GET（profiles_url）、および開いているページが取得できます。available: false または mcp_available: false の場合は、理由も示されます。
• 自分で開いたページを操作してください。自分が開いていないページへ移動するのではなく、lasso-browser の new_page を使います。人間のタブには最後に開いたページが表示されるため、ページを開くと相手の画面にも表示されます。
• 作業が終わったら、自分が開いたページを閉じてください。
• ブラウザー内の localhost は、自分のマシンではなく lasso のマシンを指します。
• ログイン済みのアカウントは人間のものです。 閲覧は問題ありませんが、投稿、送信、承認、購入には相手の許可が必要です。
• プロファイルは、それぞれ独自の Cookie、ログイン情報、プロキシを持つ別個の Chromium です。すべての lasso-browser ツールでは profile（ID または表示名）を任意で指定できます。省略するとデフォルトが使われます。ページ ID は各プロファイルに属するため、ページに関するすべての呼び出しで同じ profile を渡してください。list_browser_profiles、create_browser_profile、update_browser_profile、delete_browser_profile でプロファイルを管理します。
• /mcp からページを人間の画面に表示するには、open_browser_tab を使います。既存のタブは show_browser_tab、list_browser_tabs、close_browser_tab で管理できます。

プラグインツール

有効にしたプラグインは、/mcp に <plugin>__<tool> という名前のツールを追加します。これらはツール一覧と lasso mcp に表示されます。lasso 上のほかのツールと同様に扱ってください。