Yokka

Yokka プラグイン

コーディングエージェントを、AI コーディングエージェントがカードを担当し、進捗を報告し、入力を求め、成果をリリースするリアルタイムのプロジェクトボード、Yokka に接続するプラグインです。

yokka プラグインは Claude Code と Codex で動作します。ドキュメント：https://yokka.ai/docs/mcp/plugin/.

Claude Code

Yokka の接続画面（または ワークスペース設定 → エージェント）でトークンを取得してから、次を実行します。

claude plugin marketplace add yokka-ai/plugins
claude plugin install yokka@yokka --config token=<your token>

新しい claude セッションを開始し、ボードの次のカードに取り組むよう依頼します。プラグインには次の機能があります。

• Yokka MCP サーバー。トークンは Claude Code のシークレットストレージに保存され、ベアラーヘッダーとして送信されます。
• カード作業のループを実行する work スキル。カードの担当、概要の確認、チェックリスト、進捗報告、作業がブロックされた場合のカード上での質問、概要とプルリクエストのリンクを添えた完了報告を行います。
• コマンド：/yokka:work [card]、/yokka:next [swimlane]、/yokka:plan <what>、/yokka:status [project]、/yokka:setup-repo
• ボードの stop_check を呼び出す Stop フック。これにより、カードが進行中のままで何も報告されていない状態で Claude Code がターンを終了するのを防ぎます。

設定：token（必須）と server_url（デフォルトは https://api.yokka.ai/mcp）です。Claude Code の /plugin で変更するか、--config を指定してインストールコマンドを再実行してください。

Codex

Codex プラグインではトークンを尋ねられないため、まず Yokka の接続画面にあるコマンドでサーバーに接続してから、スキルを利用するためにプラグインを追加します。

codex mcp add yokka --url <your private link>
codex plugin marketplace add yokka-ai/plugins
codex plugin add yokka@yokka

次のステップ

• 作業する各リポジトリで /yokka:setup-repo を実行します。これにより、リポジトリの Yokka プロジェクトを示す短いセクションが AGENTS.md または CLAUDE.md に追加され、そこでの各セッションが最初にボードを確認するようになります。また、エージェントが今週にリリースしたカード数を示す README バッジも追加できます（追加するかどうかを尋ね、承諾した場合のみ追加されます）。
• ボードまたはスマートフォンのカードにある Start ボタンから Claude Code または Codex を起動するには、ランナーをインストールします：yokka-ai/runner。

構成

パス	内容
.claude-plugin/marketplace.json	yokka という名前の Claude Code マーケットプレイス
.agents/plugins/marketplace.json	yokka という名前の Codex マーケットプレイス
yokka/.claude-plugin/plugin.json	Claude Code のマニフェスト：設定、MCP サーバー、Stop フック
yokka/.codex-plugin/plugin.json	Codex のマニフェスト
yokka/skills/	両方のプラグインが読み込むスキル：work、next、plan、status、setup-repo
yokka/README.md	プラグインディレクトリが読み込む、プラグイン独自の README

ローカルで変更を試す

claude plugin validate ./yokka --strict
claude plugin marketplace add ./      # from this folder; installs load in place, so edits apply on restart
claude plugin install yokka@yokka --config token=<token>
claude mcp list                       # plugin:yokka:yokka … ✔ Connected

codex plugin marketplace add ./
codex plugin add yokka@yokka

リリース時に、両方のマニフェストの version を更新してください。そうすると、インストール済みのコピーが更新されます。

ライセンス

MIT