複数プロジェクトを一元管理。見落とし・切り替えコストをゼロに。 ローカル完結のAI-firstプロジェクト管理コンソール。デスクトップでもスマホでも、どこからでもアクセス。

• 複数案件を抱えると、各プロジェクトの状況把握に毎日30分溶ける
• タスク管理ツール、Slack、GitHub、メール...複数チャネルを行き来して疲弊
• 外出先で「あのタスク今どうなってたっけ？」→PCないと確認できない
• Claude Codeで作業→別プロジェクトに切り替え→Claude Codeセッション再起動の手間

Brainbaseなら、すべてを一箇所に集約。デスクトップでもスマホでも、いつでもプロジェクト全体が見渡せます。

複数プロジェクトのタスク・スケジュール・受信箱を一画面で確認

外出先でもスマホからタスク確認・更新が可能

プロジェクトごとにClaude Codeセッションを分離・切り替え

• 📱 モバイル対応: スマホ・タブレットからも快適にアクセス。外出先でもプロジェクト状況を確認・タスク更新が可能
• 🔒 ローカル完結: データはすべて自分のマシンに保存。クラウド不要で安全
• 🤖 AI統合: Claude Code、Cursor等のAIコーディングアシスタントと連携
• 📊 一元管理: タスク、スケジュール、Inbox、Slackメッセージを一画面で確認
• 🔄 セッション分離: プロジェクトごとにClaude Codeセッションを分離（git worktree）
• 🎨 カスタマイズ可能: YAML設定でプロジェクト・タスク管理をカスタマイズ
• 🔗 MCP統合: Gmail、Slack、Airtable、GitHub等のMCPサーバーと連携

• Node.js v20.0.0 以上
• tmux (ターミナル多重化)
• ttyd (Web ターミナル)
• Claude Code (AI コーディング支援) - 任意
• Git v2.13.0 以上 (worktree サポート)

# tmux
brew install tmux

# ttyd
brew install ttyd

# Claude Code (任意)
npm install -g @anthropic-ai/claude-code

# Git (通常は既にインストール済み)
brew install git

# tmux
sudo apt-get install tmux

# ttyd
sudo apt-get install ttyd

# Claude Code (任意)
npm install -g @anthropic-ai/claude-code

1. リポジトリクローン

   git clone https://github.com/Unson-LLC/brainbase.git
   cd brainbase

2. 依存関係インストール

   npm install

3. 初回セットアップ

   ./setup.sh

   このスクリプトは以下を実行します:

   • state.json のサンプル作成（セッション管理用）
   • _tasks/ ディレクトリ作成（サンプルタスク付き）
   • _schedules/ ディレクトリ作成（サンプルスケジュール付き）
   • _inbox/ ディレクトリ作成（受信箱）

4. サーバー起動

   npm start

5. アクセス

   デスクトップ: http://localhost:3000

   モバイル（3つの方法から選択）:

   方法1: ローカルネットワーク経由（最も簡単）

   同じWi-Fi内からのみアクセス可能

   # ローカルIPアドレスを確認
   ifconfig | grep "inet "  # macOS/Linux
   
   # スマホのブラウザでアクセス
   # 例: http://192.168.1.10:3000

   方法2: Quick Tunnels（一時的なテスト用）

   インターネット経由でアクセス可能。URLを知っていれば誰でもアクセス可能なので注意。

   # cloudflaredインストール（初回のみ）
   brew install cloudflared
   
   # Quick Tunnel起動
   cloudflared tunnel --url http://localhost:3000
   # → 表示されたURLにスマホからアクセス

   方法3: Cloudflare Tunnel + Zero Trust（本番推奨）

   前提条件:

   • ✅ 独自ドメイン（Cloudflareで管理）
   • ✅ Cloudflareアカウント（無料）

   安全・継続的に外部からアクセス可能。WARPアプリで認証必須。

   📖 詳細な手順: Cloudflare Tunnel設定ガイド

✅ これで完了！ 3分でローカル環境が整います。

# カスタムワークスペースルート（デフォルト: カレントディレクトリ）
export BRAINBASE_ROOT=/path/to/your/workspace

# カスタムポート（デフォルト: 3000、worktree内では3001）
export PORT=4000

# サーバー起動
npm start

1. プロジェクト登録

   • 左サイドバーの「+ New Session」をクリック
   • プロジェクト名とディレクトリパスを入力
   • GitHub連携（任意）、Slack連携（任意）を設定

2. タスク管理

   • プロジェクトを選択 → 「Tasks」タブ
   • _tasks/index.md に Markdown形式でタスクを記述
   • ブラウザで編集・確認が可能

3. スケジュール確認

   • 「Schedule」タブで週次・月次スケジュールを確認
   • _schedules/ 配下のYAMLファイルで管理

4. 受信箱（Inbox）

   • Gmail、Slackからの通知を一元表示
   • MCP連携で自動取得

5. セッション切り替え

   • プロジェクトタブをクリックで即座に切り替え
   • Claude Codeセッションも自動切り替え（git worktree使用）

詳細: ユーザーガイド

Brainbaseは git worktree を活用し、プロジェクトごとにClaude Codeセッションを分離します。

従来の問題:

• プロジェクトAで作業中 → プロジェクトBに切り替え → Claude Codeセッションが混在
• ブランチ切り替えのたびに作業ディレクトリが変わり、コンテキストが失われる

worktreeの利点:

• 並行作業: 同じリポジトリの複数ブランチを同時に開ける
• セッション分離: プロジェクトごとにClaude Codeセッションを維持
• 高速切り替え: ディレクトリ移動のみでプロジェクト切り替え完了

Brainbaseは初回起動時に自動的にworktreeを作成します。手動操作は不要です。

詳細: git worktree ガイド

┌─────────────────────────────────────────┐
│           UI Components (View)           │
├─────────────────────────────────────────┤
│        Services (Business Logic)         │
├─────────────────────────────────────────┤
│      Repositories (Data Access)          │
├─────────────────────────────────────────┤
│      EventBus (Cross-Cutting)            │
└─────────────────────────────────────────┘

Brainbaseは以下のアーキテクチャパターンを採用:

• Event-Driven Architecture: EventBus, Reactive Store, DI Container
• Test-Driven Development: 80%+ coverage, Red-Green-Refactor cycle
• Service Layer Pattern: ビジネスロジックの一元化

詳細: DESIGN.md

• 開発者向けガイド - 開発標準・アーキテクチャ原則
• 設計ドキュメント - UI/UX設計・データフロー
• リファクタリング計画 - 3-Phase移行戦略
• git worktree ガイド - worktree詳細説明

We welcome contributions! Please see CONTRIBUTING.md for details.

開発ワークフロー:

1. Explore: 既存コード調査
2. Plan: 実装方針決定
3. Branch: feature/session/* branch作成
4. Edit: TDD実装 (Red-Green-Refactor)
5. Test: カバレッジ80%以上
6. Commit: Decision capture + Conventional Commits
7. Merge: --no-ff merge to main

A: tmuxがインストールされているか確認してください。

tmux -V
# tmux 3.x 以上が必要

A: Claude CodeのAPIキーが設定されているか確認してください。

claude-code --version
# v1.0.0 以上推奨

A: ファイアウォール設定を確認し、ポート3000が開放されているか確認してください。

# macOS
sudo lsof -i :3000

# ローカルIPアドレス確認
ifconfig | grep "inet "

A: Git v2.13.0以上が必要です。バージョンを確認してください。

git --version

A: 可能です。以下を手動で実行してください:

cp state.sample.json state.json
cp -r _tasks-sample _tasks
cp -r _schedules-sample _schedules
cp -r _inbox-sample _inbox

その他のトラブルは Issues で報告してください。

This project is licensed under the MIT License - see the LICENSE file for details.

🤖 Built with Claude Code