agent-wiki

agent-wiki — Claude Code プラグイン

agent-wiki は、MCP 経由でエージェントにプライベートな Markdown プロジェクトメモリを提供します。この公開リポジトリでは、明示的に呼び出す /agent-wiki:setup スキルと、https://getagentwiki.com/mcp のリモートサーバーを含むバージョン 0.3.0 を配布しています。認証情報、依存関係、自動書き込みフックはバンドルされていません。

インストール

まず、Claude Code で /mcp を確認してください。agent-wiki が直接サーバーまたは claude.ai コネクター経由ですでに動作している場合は、その接続を維持し、インストールする前に既存の接続をお読みください。

シェルで次のコマンドを実行してください。

claude plugin marketplace add animal-ltd/agent-wiki-plugin
claude plugin install agent-wiki@agent-wiki --scope user

対話形式で同じ操作を行うには、/plugin marketplace add animal-ltd/agent-wiki-plugin と /plugin install agent-wiki@agent-wiki を実行し、プラグインマネージャーで適切なスコープを選択してください。

• user：すべてのプロジェクトでスキルとバンドルされたサーバーを利用できます。
• project：このリポジトリの Claude 設定を通じて、共同作業者と共有されます。
• local：このプロジェクトで自分だけが利用できます。

意図した場合に限り、--scope project または --scope local を使用してください。プロジェクトディレクトリで --scope user を指定してインストールしても、すべてのプロジェクトに適用されます。インストールスコープによって wiki へのアクセス権が付与されるわけではありません。バンドルされたエンドポイントはアカウント全体で利用できます。ご自身でその広範な接続を選択しない限り、既存の単一 wiki への接続を置き換えないでください。

Claude Code を再起動してください。/plugin の Installed で agent-wiki バージョン 0.3.0 が有効になっていることを確認し、/agent-wiki:setup が見つからない場合は Errors を確認してください。/reload-plugins を要求するクライアントでは、その方法も利用できます。クライアントの再読み込み手順に従ってください。シェルからインストールしても、すでに実行中の会話は更新されません。

認証してからセットアップを実行する

インストールで読み込まれるのはスキルとサーバーのみです。/mcp を開き、アクティブな agent-wiki サーバーを選択して、必要に応じて Authenticate または Re-authenticate を選択してください。ブラウザーでサインインと承認を完了し、待機中のクライアントに戻ります。認証情報や OAuth コールバック URL を共有しないでください。agent-wiki という名前の直接サーバーの場合、Claude Code v2.1.186 以降では claude mcp login agent-wiki も使用できます。非対話型のプロンプトでは、対話型 OAuth を完了できません。

/mcp に接続とツールが表示されたら、次を呼び出してください。

/agent-wiki:setup

wiki 名または ID を指定できます。スキルは list_wikis でアクセスを確認し、選択が曖昧な場合は質問して、wiki の状態を確認し、最大 3 ページの概要を読み取ります。既存の接続を使用して、プライベートなプロジェクト指示と読み取り専用の検索フックを設定します。ネイティブフックには Claude Code 2.1.282 以降が必要です。検索を有効にする前に、貼り付けたテキストを含む現在の各プロンプトが検索のために一時的に送信されることを説明し、指示のみを設定する選択肢も提示します。このフックは、別個の会話履歴、ローカルパス、認証情報のフィールドを追加しませんが、プロンプトに含まれるすべてのテキストが送信されます。agent-wiki はプロンプトのテキストをログに保持しません。クライアントの会話履歴は別途管理されます。既存の設定、権限、その他のフックは維持されます。

設定に新たな決定を保存する必要はありません。必要な場合、アシスタントは正確なメモと保存先を示し、承認を待ちます。安定した書き込みリクエスト ID を使用し、現在のバージョンを維持して、保存されたリビジョンを確認し、結果を検索します。既存の決定は再度保存されません。例は決定として保存されません。

認証情報の有効期限が切れた場合は、/mcp に戻り、選択した接続を再認証してください。権限が読み取り専用である場合、アクセス権がない場合、ツール呼び出しが拒否された場合、またはキャンセルした場合、セットアップは未完了の項目を報告し、失敗を回避しません。再実行時には、決定を重複して保存するのではなく、すでに保存済みかどうかを確認します。保存後に確認に失敗した場合は、完了ではなく未確認として報告します。

既存の接続

/mcp では、サーバーの接続元と非表示の重複を確認できます。同じ URL を指すプラグインサーバーや継承された claude.ai コネクターより、直接定義した接続が優先される場合があります。セットアップスキルでは、既存の接続を確認して使用できます。インストールのために既存の接続を削除する必要はありません。使用可能な接続が複数ある場合は、明示的に選択してください。一覧を短くするためだけに、動作中のサーバーを削除したり、重複する接続を認証したりしないでください。

claude.ai からの継承は、現在のログイン方法によって異なります。/status を確認してください。API キーやその他のプロバイダー認証では、継承されたコネクターは読み込まれません。以前 claude.ai にログインしたことがあっても、現在も継承されているとは限りません。継承されたコネクターに認証が必要な場合は、claude.ai のコントロールを使用してください。Claude Code のセッショントークンが拒否された場合は、/login が必要です。ログイン方法や接続範囲の変更はご自身で選択するものであり、セットアップの一環として自動的に行われることはありません。Anthropic の MCP ドキュメントで、現在の動作を説明しています。

プラグインを使わない場合は、claude mcp add --transport http agent-wiki https://getagentwiki.com/mcp で直接接続を引き続き利用できます。デフォルトのローカルスコープは、このプロジェクトでのご自身の利用を対象とします。セットアップスキルはインストールされません。既存の接続を確認してから、別途認証してください。

以前のリリースからアップグレードする

既存のインストールと同じスコープを使用してください（/plugin に表示されています）。

claude plugin marketplace update agent-wiki
claude plugin update agent-wiki@agent-wiki --scope user

Claude Code を再起動し、/plugin でバージョン 0.3.0 を確認してから、使用前に /agent-wiki:setup が利用可能であることを確認してください。カタログの更新だけではプラグインは更新されません。キャッシュの更新はプラグインのバージョンによって制御されます。キャッシュされたランタイムファイルは編集しないでください。古いバージョンのままの場合は、更新の出力、マーケットプレイスのソース、選択したスコープ、/plugin の Errors を確認してください。Claude の設定全体や認証情報のキャッシュを消去しないでください。

これらは Claude Code 2.1.282 でサポートされているコマンドです。プラグインリファレンスとインストールガイドを参照してください。テスト済みバージョンや公開リリースの SHA など、クライアントの受け入れ記録は #83 で管理されています。ソースの確認だけでは、認証やセットアップの成功は証明されません。

ロールバック

このバージョンの使用を停止するには、/plugin で無効にして再起動してください。これによって Wiki のコンテンツが削除されることはありません。直接接続は引き続き使用できます。

取得フックはプロジェクトローカルで、プラグインの有効化とは独立しています。自動取得を停止するには、Claude に .claude/settings.local.json から agent-wiki の UserPromptSubmit フックとして認識されたものだけを削除するよう依頼してください。他のフック、権限、既存の接続はそのまま保持してください。マーク付きの指示は、別途保持するか、意図的に削除してください。

以前公開された 0.1.0 の成果物を使用している場合は、まずマーケットプレイスのソースとインストールのスコープを確認してください。このマーケットプレイスには agent-wiki のみが含まれています。削除するとそのプラグインがアンインストールされるため、このインストールを置き換えると決めた場合にのみ実行してください。

git clone https://github.com/animal-ltd/agent-wiki-plugin.git agent-wiki-plugin-rollback
git -C agent-wiki-plugin-rollback checkout --detach 81a790d715dfbd9412d1a30862d9c297afc290d7
claude plugin marketplace remove agent-wiki
claude plugin marketplace add ./agent-wiki-plugin-rollback
claude plugin install agent-wiki@agent-wiki --scope user

再起動して、/plugin で 0.1.0 を確認してください。旧成果物には MCP サーバーがありますが、セットアップスキルはありません。アップグレードの準備ができるまで、そのチェックアウトを固定されたコミットのまま維持し、ディレクトリを更新または削除しないでください。最新リリースに戻すには、上記の固定されていない公開ソースに置き換えてください。全体を通して、元のインストールスコープを使用してください。Wiki への書き込みには独立したバージョン履歴があります。プラグインをロールバックしても、Wiki への書き込みは取り消されません。

メンテナー

正規のソースは animal-ltd/agent-wiki です。対象は plugins/agent-wiki、.claude-plugin/marketplace.json、この README（同リポジトリの plugins/README.md）、plugins/LICENSE、scripts/verify-plugin-package.mjs です。コミット済みのソースから scripts/export-plugin.mjs を使ってエクスポートし、レビュー済みの公開 PR として提出してください。公開コピーを手作業で編集したり、無人の同期を main にプッシュしたりしないでください。

SOURCE.json には、アプリケーションソースの SHA、エクスポートされた各ファイルの SHA-256、結合チェックサム、生成された初回プロンプトのチェックサムが記録されています。Node.js 22 以降を使用して、自己完結型の公開アーティファクトを検証してください。

node scripts/verify-plugin-package.mjs .
claude plugin validate . --strict
claude plugin validate plugins/agent-wiki --strict

この証明書は整合性の確認用であり、署名ではありません。独立したアプリケーションのエクスポートとレビュー済みのコミットを照合してください。公開リリースの SHA とクライアントの証明書はソースコミットの外部に保管されるため、証明書が自身のハッシュを参照することはありません。

セットアップガイド · プライバシー · 利用規約 · セキュリティ