agent-harness
ar27111994 · コーディング · 生産性向上
agent-harness は、AIコーディングエージェントを動かす再利用可能な資産、つまりスキル、MCPサーバー、指示ファイル、プロンプトパックを管理するオープンソース CLI だ。MCPサーバーのパッケージマネージャーが欲しいと思ったことがあるなら、これがかなり近い。ワークスペースを走査し、作業に合う資産を選び、固定したローカルコピーに複製し、使っているホストに接続する。VS Code、Cursor、Zed、Claude Code、OpenCode、Pi、Codex のいずれでも動く。AIエージェント向け CLI としての役割は狭く明確だ。エージェントに何を使わせるかを決める。
agent-harness について
agent-harness とは
agent-harness は Node.js と TypeScript で書かれた CLI で、AIコーディングエージェントを扱ううえで退屈で間違いやすい部分、つまり再利用可能な資産を整頓する作業を引き受ける。AIエージェント向け資産管理ツールと呼ぶ人もいて、その表現は当たっている。いまや多くの開発者が、スキル、MCPサーバー、指示ファイル、プロンプトパックを複数のエディタで掛け持ちしている。どのツールもそれらの資産を別々の場所と別々の形式で求める。agent-harness はその混沌を、繰り返し使える単一のライフサイクルに変える。
エージェントを実行するわけではない。すでに使っているホスト向けに、検査可能な入力を作る。何かが変わる前に、ワークスペースに入るものを確認できる。中核の設計は意図的に素朴だ。単一のコマンド面、ホストアダプター層、プレビュー優先の書き込み、明示的なネイティブ導入ステップ。プロジェクトは MIT ライセンスで、GitHub にある。
最大の制約は対応範囲だ。7つのコーディングホストの資産を管理し、Node 23 以上を要求する。作業が完全にブラウザ内で完結する場合や、対応リストにないツールを使う場合には、まだ役に立たない。では誰が不要か。1つのホストしか触らず、設定も変えない人だ。まだ若いプロジェクトでもあるため、大きなパッケージマネージャーに比べて実運用の事例は少ない。
はじめかた
- Node.js 23 以上、npm、Git を導入し、
npm install -g @ar27111994/agent-harnessを実行する。 - 設定したいワークスペースで、
agent-harness setup hostsとagent-harness setup doctor --host vscodeを使い、自分のホストが何に対応するか確認する（vscode は自分のホストに置き換える）。 - 一連の処理を一度に走らせる。
agent-harness workspace opencode --intent generalを実行し、frontendやresearchなどプロジェクトに合う意図を選ぶ。 - 生成された
.agent-harness/フォルダーを調べ、何が見つかり、選ばれ、整えられたかを確認する。 - 必要が変わったら同じコマンドを再実行する。適用前に予定されたファイル変更を見たいときは、まずプレビューモードを使う。
AIツール情報
agent-harnessの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- 複数の AIコーディングホストを掛け持ちする開発者。ターミナルに慣れていれば、VS Code、Cursor、Zed、Claude Code、OpenCode、Pi、Codex で同じ資産一式を一貫して保てる。
- 再現できる設定を求めるチーム。固定した複製とプレビュー優先の書き込みが、何が変わったかを確認できる記録を残す。ホスト型ダッシュボードはないため、確認はローカルで行う。
- オープンソースの貢献者やいじり好き。MIT ライセンスとアダプター設計のおかげで拡張しやすい。ただし TypeScript が読めることが条件だ。
タスク
- MCPサーバーの導入と接続。設定ファイルを手作業で編集する代わりに、範囲を絞ったサーバー群を整え、ホストごとに適用する。
- エージェントスキルと指示の管理。資産は自動で発見・順位付け・有効化されるため、プロジェクト間で markdown をコピーしなくて済む。
- エージェントが何にアクセスできるかの監査。実行のたびに `.agent-harness/` の下へ検査可能な JSON を書き出すため、ある機能がどこから来たかを追うときに役立つ。
- 既存設定の更新。同じライフサイクルをそのまま再実行できるので、資産の更新はゼロからのやり直しにならない。
シーン
- プロジェクト途中でのエディタ切り替え。同じ資産パイプラインがスキルと MCPサーバーを新しいホストへ運ぶ。
- 同僚の受け入れ。同じワークスペースコマンドを実行すれば、近い資産環境にたどり着く。
- 危険な入力の遮断。安全でないと思われる候補は、ワークスペースへ直行せず隔離フォルダーを通る。
主な機能
ホストをまたぐ資産ライフサイクル
agent-harness はどのホストを選んでも同じライフサイクルを回す。発見、推薦、複製、整備、有効化、そして接続。この一貫性が重要なのは、土台となるツール同士が何も一致していないからだ。Claude Code で動くスキルは Cursor 向けと同じようには梱包されていない。このツールはそうした違いを単一のコマンド面の裏でならす。1つの面、1つのライフサイクル。
コマンド1つでのワークスペース設定
workspace <host> コマンドは新規ユーザー向けの既定の道筋だ。広範な発見を行い、候補を順位付けし、選んだ資産を整えて有効化し、最後にホストの接続を済ませる。agent-harness workspace cursor --intent frontend のような1行で完結する。devops、design、research といった意図が選択を自分の仕事の種類へ導き、複数指定もできる。設定は1行。そこが魅力だ。
プレビュー優先の接続
ホストの接続は、求めない限り何も変更しない。既定では wire <host> は確認できる計画を書き出すだけで、何も触らない。正確な対象パスと予定された書き込みを読み、準備ができたら適用またはリセットする。ツールにエディタ設定を黙って書き換えられた経験がある人には、ありがたい一線だ。
固定した複製と隔離
インターネットから資産を直接ワークスペースへ引き込むのではなく、範囲を絞った資産群を再現可能なローカル成果物へ複製し、世代ごとに固定する。危険に見える候補は、有効化せず隔離フォルダーへ回す。その結果、足元で動き続ける設定ではなく、検査して巻き戻せる設定になる。
ARD の発行者と利用者
agent-harness は Agentic Resource Discovery 1.0 仕様を実装する。Google、Microsoft、Hugging Face、GitHub、NVIDIA が支える標準だ。.well-known/ai-catalog.json を公開し、レジストリが厳選した資産を索引できるようにし、他の ARD レジストリを発見元として利用もできる。キャッチコピーが意図を要約している。どこでも発見し、どこへでも導入する。
7つのホストアダプター
プロジェクトは VS Code（Copilot 併用）、OpenCode、Cursor、Zed、Claude Code、Pi、OpenAI Codex のアダプターを登録する。各アダプターが自ホストのファイル、設定、適用とリセットの挙動、安全境界を担う。中には別のホストのパッケージ配置を流用しつつ、独自のポリシーで順位付けするものもあり、たとえば Cursor は Copilot 流の資産と互換性を保つ。
意図を踏まえた推薦
推薦は人気だけでなく、ポリシー、需要の signal、信頼、コスト、多様性を重み付けする。公式および検証済みのソースが優先され、所有者の根拠が噛み合わないときは一次ソースを下げる。結果として、怪しいパッケージがワークスペースへ届く件数は減り、いま作っているものに本当に合うものの割合が増える。
メリットとデメリット
メリット
- 7つの人気 AIコーディングホストにまたがる実際の問題を、単一のコマンド面で解決する
- プレビュー優先の書き込みと固定した複製により、変更が検査可能で巻き戻せる
- MIT の下で無料かつオープンソースで、拡張向けのクリーンなアダプター設計を備える
- 隔離の扱いと信頼を踏まえた順位付けが、供給網への警戒を一段加える
デメリット
- Node.js 23 以上を要求するため、古い環境はまずアップグレードが要る
- ブラウザや CLI 以外のホストには対応せず、一部の作業フローを完全に除外する
- まだ初期で利用者も少ないため、端の事例やドキュメントが後れを取りうる
- ターミナルへの習熟を前提とし、気軽な利用者には手が届かない
よくある質問
AIコーディングエージェントが頼る再利用可能な資産、つまりスキル、MCPサーバー、指示、プロンプトパックを管理する。候補を発見し、順位付けし、固定したローカルコピーを複製し、選んだものを自分のホストへ接続する。エージェント自体を実行することはない。
関連コンテンツ
agent-harnessに関連するツール、スキル、記事を探す。
agent-harnessの代替ツール
Forefront
Forefront · コーディングForefrontはオープンソースAIで構築するためのウェブプラットフォームだ。主要なオープンソース言語モデルを自分のデータで微調整し、性能を評価し、API経由で実行したり、エクスポートして自分でホストしたりできる。クローズドなプラットフォームの手軽さを求めつつ、モデルとデータの所有権にはこだわる開発者が対象だ。
Startkit
StartKit.AI · コーディングStartkitは、AI SaaSとAIラッパー製品を作るためのボイラープレートだ。面倒な部分をあらかじめ配線済みにしたAIスタートアップボイラープレートと考えればいい。認証、StripeとLemon Squeezyの決済、利用制限、トランザクションメール、そしてOpenAI、Anthropic、Groq、Llamaと通信するAI APIスターターキットが含まれる。リポジトリをクローンして価格を設定し、ユーザーが実際にお金を払う部分に取りかかれる。ReactとTailwind上のNext.jsで作られているため、ボイラープレートコードの多くはすでに見慣れたものだ。
Testim
Tricentis · コーディングTestimは、Web・モバイル・Salesforceアプリ向けにエンドツーエンドテストを構築して実行するAIテスト自動化プラットフォームだ。機械学習を頼りに、インターフェースが変わってもテストを安定させ、チームが壊れたセレクターの修正に費やす時間を減らす。今日から使い始められる自動テストツールとしては悪くない。ブラウザで操作を録画してテストを作り、より細かい制御が必要なときはJavaScriptを足す。忙しいQAチームにとって堅実な選択肢である。