devboard
プロジェクトの入ったフォルダを指すだけで自動スキャンし、中身・README・Git の状態をブラウザで一望できる軽量な開発コンソール。Docker と Python 標準ライブラリと git だけで動きます。
機能
プロジェクトの自動検出
.git / package.json / pyproject.toml / Cargo.toml / go.mod などのコードマーカーに加え、README や CLAUDE.md などのドキュメントだけのフォルダも拾います。
AIツールの判別
Claude Code・Codex・Cursor・Copilot・Gemini・Aider・Continue の利用痕跡を検出して表示します。
Git ステータス
ブランチ、未コミット変更、ahead/behind、最終コミット、リモートを一覧に表示。最終アクティビティ順に並べ替えできます。
README とファイルツリー
README をレンダリングし、フォルダをクリックすると中身をその場で3階層まで展開します。
タグ・お気に入り・メモ
プロジェクトごとの情報は <project>/.devboard/ に保存されます。
ドラッグ&ドロップ投入
フォルダや .zip をそのまま画面に落として追加。__MACOSX/ や .DS_Store は自動で除去されます。
インストール
必要なのは Docker と Docker Compose だけ。git はイメージに同梱されているのでホスト側へのインストールは不要です。起動後 http://localhost:8080 を開きます。
git clone https://github.com/hiropon164/devboard.git
cd devboard
docker compose up -d --build
# http://localhost:8080技術スタック
Python 3.12+
標準ライブラリのみ
Docker / Compose
git
HTTP JSON API
対応状況と制限
| 設定 | PROJECTS_DIR / PORT / SCAN_DEPTH / CACHE_TTL / MAX_UPLOAD_MB などを docker-compose.yml の環境変数で指定します。 |
|---|---|
| IDE 連携 | IDE_REMOTE_HOST と IDE_HOST_PROJECTS を設定すると「VS Code / Cursor で開く」ボタンが有効になります。 |
| API | /api/projects、/api/project、/api/tags の JSON API があり、スクリプトからも扱えます。 |
| 注意 | ファイルのアップロード・アーカイブ・削除ができます（削除は ./projects/.trash へ移動）。自己責任でご利用ください。 |