A command deck for everyone juggling a pile of Claude Code & Codex projects.
See every repo's state at a glance — git status, how long it's been neglected, your Claude Code and Codex session history — and jump back in with one click (claude -c / codex resume).
If you run Claude Code across a dozen side projects, you lose the thread: Which repos have uncommitted work? Which have I not touched in weeks? What was I even doing in that one? DevDeck is a always-on desktop deck that answers those at a glance and gets you back into a session in one click — without touching your code or files.
- 🗂 Project deck — every git repo under your scan locations as a card: branch, uncommitted count, last commit, AI session count.
- 🤖 Multi-agent (Claude Code & Codex) — choose your active agent; the deck shows that agent's sessions and Open launches it (
claude -c/codex resume). A toolbar switcher appears when both CLIs are installed. - 📂 Multiple scan locations — point DevDeck at several folders to scan for repos, or add individual repos that live anywhere; each is auto-detected.
- 🚦 Staleness traffic-light — fresh / warning / neglected, so dirty or abandoned repos surface themselves.
- ▶ One-click resume — opens a terminal in the repo and continues your last session with the active agent (
claude -c/codex resume) — or pick a specific past session. - ↩ Resume cue — auto-reads the last thing you asked in each project's newest session (Claude or Codex) and shows it in the note slot, so "where was I?" needs no typing. Click to adopt it as your note.
- 📋 "Next" view — every project's note (or resume cue) gathered into one cross-project "what's next" list.
- ↑ Unpushed signal — commits ahead of your remote, flagged on the card so unprotected work stands out.
- { } Open in editor (VS Code) and 📁 open folder straight from a card; the deck auto-refreshes while it's open.
- 📝 Per-project notes — jot your next todo; it sticks with the card.
- 📊 Usage analytics — tokens, cache-hit rate, and an API-equivalent cost estimate, parsed locally from
~/.claude. - 📌 Pin / 🙈 hide / 🔎 search / sort — keep the deck focused.
- 🌐 4 languages — English, 한국어, 日本語, 中文.
- ⬆ Auto-update — checks GitHub Releases on launch and offers an in-app, user-confirmed download + restart (Windows/Linux; macOS pending code-signing).
- 🔒 Fully local & offline — reads your local agent data and git, sends nothing anywhere (
connect-src 'none'); the only network call is the update check. No account, no telemetry. - System tray + global shortcut (
Ctrl+Alt+D), frameless Discord-style title bar.
Grab the latest from Releases:
| OS | Download | First run (unsigned build) |
|---|---|---|
| Windows | DevDeck-0.5.0-Setup.exe — or DevDeck-0.5.0-win.zip (portable, no installer) |
SmartScreen → More info → Run anyway |
| macOS — Apple Silicon | DevDeck-0.5.0-arm64.dmg |
Right-click the app → Open (Gatekeeper) |
| macOS — Intel | DevDeck-0.5.0-x64.dmg |
Right-click the app → Open |
| Linux | DevDeck-0.5.0-x86_64.AppImage (portable) or …-amd64.deb |
chmod +x the AppImage, then run |
Builds are unsigned (no code-signing certificate yet), so the first launch needs the bypass above. On Windows, if Setup.exe won't launch, use the portable …-win.zip instead — extract it anywhere and run DevDeck.exe (no installer involved). Then open Settings and add the folders that hold your git repos (defaults to ~/Documents/GitHub); you can add several scan locations or pin individual repos.
| OS | Status |
|---|---|
| Windows | ✅ Supported — Windows Terminal / PowerShell. Installer provided. |
| macOS | ✅ Supported — opens Terminal.app via osascript. .dmg provided (arm64 + x64). Launcher logic + AppleScript are validated on real macOS CI runners; GUI hardware-testing & signing still pending — feedback welcome. |
| Linux | ✅ Supported — auto-detects gnome-terminal / konsole / alacritty / kitty / xterm (and x-terminal-emulator). AppImage + .deb provided. |
Every release is built and unit-tested on real Windows, macOS, and Linux GitHub Actions runners; the macOS
.dmgis produced on a genuine Mac runner.
git clone https://github.com/writingdeveloper/devdeck.git
cd devdeck
npm install
npm start # build + launch
npm test # run the test suite (Vitest)
npm run dist # package to release/win-unpacked (needs Windows Developer Mode for a clean run)DevDeck scans your configured scan locations for git repos (walking org/repo layouts, plus any individual repos you add), reads each repo's git state, and cross-references your AI coding sessions — Claude Code (~/.claude/projects) or Codex (~/.codex/sessions). Everything runs in the Electron main process and stays on your machine — DevDeck only reads your data and launches a terminal; it never edits your project files. New agents plug in behind one AgentProvider interface.
Tech: Electron 31 · TypeScript · esbuild · Vitest · electron-updater. Hardened renderer (context isolation, sandbox, strict CSP).
Issues and PRs welcome — especially code-signing (Windows/macOS), the top roadmap item: it removes the SmartScreen/Gatekeeper friction and unlocks macOS auto-update. This is an early project; expect rough edges.
MIT © Si Hyeong Lee