aipanel

aipanel は、Claude Code を provider として使いながら、相談、継続会話、デバッグ調査を CLI で進めるための TypeScript 製 broker / orchestrator です。

現時点の phase 1 では、claude-code 単独 provider を前提に、Session / Run / Artifact を aipanel 側で正本管理します。

Current Status

• phase 1 実装済み
• provider は claude-code のみ
• 利用可能 command は providers, consult, followup, debug
• compare は phase 2 予約で、内部 placeholder のみ残している

Setup

npm install
npm run build

Makefile を使う場合は以下でも同じです。

make install
make build

ビルド後は以下で実行できます。

node dist/bin/aipanel.js providers --json

Package Install

公開後は package として install できます。

npm install -g @sean-sunagaku/aipanel
aipanel providers --json

公開前のローカル確認は tarball か Makefile で行えます。

tarball="$(npm pack)"
npm install -g "./${tarball}"
aipanel providers --json

make pack-dry-run
make verify-package

公開前の最終確認:

make publish-check

公開:

make publish

Commands

node dist/bin/aipanel.js providers [--json]
node dist/bin/aipanel.js consult "<question>" [--cwd <dir>] [--file <path>] [--diff <path>] [--log <path>] [--timeout <ms>] [--json]
node dist/bin/aipanel.js followup --session <sessionId> "<question>" [--cwd <dir>] [--timeout <ms>] [--json]
node dist/bin/aipanel.js debug "<question>" [--cwd <dir>] [--file <path>] [--diff <path>] [--log <path>] [--timeout <ms>] [--json]

よく使う例:

node dist/bin/aipanel.js consult "この設計どう？" --json
node dist/bin/aipanel.js consult "このログから原因わかる？" --cwd ./repo --log logs/app.log --file src/server.ts --json
node dist/bin/aipanel.js followup --session session_xxx "この修正方針で進めていい？" --json
node dist/bin/aipanel.js debug "この不具合の根本原因は？" --cwd ./repo --file src/cache.ts --log logs/error.log --json

Runtime Notes

• --cwd は provider 実行ディレクトリだけでなく、--file, --diff, --log の相対パス解決にも使われます
• AIPANEL_STORAGE_ROOT を指定すると、session / run / artifact の保存先を切り替えられます
• followup は Claude Code の native resume を正本にせず、aipanel 側の session 履歴再構築を基本にしています

例:

AIPANEL_STORAGE_ROOT="$(mktemp -d)" node dist/bin/aipanel.js consult "Reply with exactly: ready" --json --timeout 30000

Storage Layout

デフォルトでは ./.aipanel 配下に保存します。

.aipanel/
  sessions/
    <sessionId>.json
  runs/
    <runId>.json
  artifacts/
    <runId>/
      <artifactId>.json
      <artifactId>.artifact.json

主な保存内容:

• sessions/: Session, SessionTurn, ProviderRef
• runs/: Run, RunTask, TaskResult, ContextBundle, ProviderResponse, NormalizedResponse, ComparisonReport
• artifacts/: context bundle, provider raw text/json, debug task outputs

Tests

npm run typecheck
npm run test:unit
npm run test:integration
npm run test:e2e
npm test

Makefile 経由でも同じ確認ができます。

make typecheck
make test

テストの役割:

• test:unit: ResponseNormalizer, ContextCollector, SessionManager
• test:integration: built CLI + fake Claude provider で providers/consult/followup/debug
• test:e2e: built CLI の永続化込みフルフロー確認

Verified Smoke Checks

2026-03-10 JST 時点で、以下を実行確認済みです。

• npm run typecheck
• npm test
• npm run build
• npm run verify:package
• node dist/bin/aipanel.js providers --json
• 実 Claude Code を使った consult
• 実 Claude Code を使った followup
• 実 Claude Code を使った debug

Repo Skill

• repo-local Codex skill は .agent/skills/aipanel/SKILL.md にあります
• install / build / command usage / storage inspection / tests / E2E の入口を 1 本にまとめています
• アーキテクチャ図の再生成用 Skill は .agent/skills/aipanel-diagrams/SKILL.md にあります
• Skill の参照ドキュメントは docs/skills/aipanel-diagrams/00_overview.md にあります
• draw.io 専用 sub-agent 定義は drawio-diagrammer.yaml にあります

Architecture Docs

• Overview
• Current Implementation Diagrams
• Comparison
• Recommended Architecture
• Formal Architecture
• Implementation Plan
• Class Design
• Data Flow
• Broker + Orchestrator Internal Design
• NPM Package Distribution