Skip to content

README.md

Latest commit

 

History

History
128 lines (90 loc) · 7 KB

README.md

File metadata and controls

128 lines (90 loc) · 7 KB
Raw
DevDeck logo

DevDeck

A local-first command center for Claude Code, Codex, and Antigravity projects.

See every repository, live agent session, next task, local usage estimate, and resume cue in one stable workspace.

License Platform Built with Electron Tests CI

What DevDeck solves

AI coding work gets fragmented quickly: one repository is waiting for a response, another has uncommitted work, and a third has a conversation you meant to resume. DevDeck keeps those contexts together without uploading your project or transcript data.

The interface is organized as one command center:

  • The sidebar contains Quick Open, primary views, urgency-grouped live sessions, and compact projects. Drag its edge to any width between 180 and 460px; the choice is remembered.
  • The sidebar collapses to 52px on desktop and becomes a Sessions/Needs You drawer at narrow widths.
  • The main project overview defaults to a row-first status board with localized text-and-shape status; cards remain optional.
  • Selecting a session focuses its existing embedded terminal without respawning or remounting it.
  • Project Memory opens as a right-side drawer, or a full-width sheet on narrow windows.
DevDeck row-first project command center

Highlights

  • Unified project and session navigation — Needs You and Working sessions stay visible from Projects, Tasks, Usage, and Settings. Previous sessions expose restore, warning, pin, forget, and Restore All actions in the same shell. Quick Open (Ctrl+Shift+P, reachable from inside a terminal) filters both sessions and projects.
  • Built for long lists — every group orders by last activity, folds to a counted header, and caps itself with a "show more"; the project list shows your recent repositories with the rest one click away. Unpinning names the group it moved the session to and offers an undo.
  • Row-first project overview — resume cues lead each row; branch, working-tree state, providers, sessions, cost, tasks, GitHub, editor, folder, and provider-aware Open remain available.
  • Provider-aware Open — focus a live session, continue the correct provider-owned conversation, start a fresh session, or explicitly choose another installed provider.
  • Cockpit on Windows — embedded Claude Code, Codex, and Antigravity terminals with persistence, restart, fork, rename, pin, close confirmation, search, clipboard handling, clickable links and image paths, context percentage, and summaries.
  • External terminals on macOS and Linux — the same project actions launch supported native terminal applications.
  • Project Memory — an on-demand local snapshot of the latest conversation, Git state, recent commits, tasks, notes, and activity timeline. It makes no AI or network call.
  • Cross-project Tasks — add, edit, complete, schedule, filter, and view tasks as a list or calendar.
  • Local usage analytics — combined Claude Code and Codex token and API-equivalent cost estimates, provider filters, model/day/project breakdowns, and deleted-project history.
  • Live provider limits — a fixed 26px footer summarizes the most urgent supported limit; the dialog keeps each provider independent and preserves last-good data.
  • Repository signals — uncommitted files, unpushed commits, staleness, session history, resume cues, notes, pin/hide, GitHub, editor, and folder actions.
  • Four languages — English, 한국어, 日本語, 中文.
  • Local-first security — context isolation, sandboxing, strict CSP, no telemetry, and no project data sent by the renderer.
Cross-project task board Combined Claude Code and Codex local analytics
DevDeck settings Live limits for installed providers
Urgency-grouped sessions in the shared command-center sidebar

Install

Download the latest build from Releases.

OS Download First run
Windows DevDeck-…-Setup.exe SmartScreen → More info → Run anyway
macOS Apple Silicon DevDeck-…-arm64.dmg Privacy & Security → Open Anyway
macOS Intel DevDeck-…-x64.dmg Privacy & Security → Open Anyway
Linux …-x86_64.AppImage or …-amd64.deb chmod +x for AppImage

Builds are currently unsigned. After launch, open Settings and add scan roots or individual project folders; DevDeck scans nothing until you choose them.

On macOS, allow Terminal automation when prompted. On macOS 15 or later, launch once and use System Settings → Privacy & Security → Open Anyway for the unsigned build.

Platform support

OS Project actions Embedded Cockpit
Windows Windows Terminal / PowerShell Yes
macOS Terminal.app through osascript No
Linux Auto-detected supported terminal No

Every release is built and unit-tested on Windows, macOS, and Linux CI runners.

The command-center UI is also exercised in Electron at desktop and 520px widths across all four languages, followed by automated accessibility audits.

Build from source

git clone https://github.com/writingdeveloper/devdeck.git
cd devdeck
npm install
npm start

Useful checks:

npm test
npm run build
npm run qa
npm run qa:audit

How it works

DevDeck scans only the folders you authorize, reads Git state, and correlates local session data from:

  • Claude Code: ~/.claude/projects
  • Codex: ~/.codex/sessions
  • Antigravity: ~/.gemini/antigravity

Project scanning, transcript parsing, Git calls, terminal processes, and provider usage checks stay in the Electron main process. The sandboxed renderer receives normalized view models through guarded IPC. New agents plug in behind the existing provider interface.

Outbound traffic is limited to first-party update or supported usage endpoints. DevDeck has no account system and no telemetry. Codex credentials are never read by DevDeck; its official app server owns its authentication.

Tech

Electron 43 · TypeScript · esbuild · Vitest · Playwright · axe-core · electron-updater

Contributing

Issues and pull requests are welcome. Code signing for Windows and macOS remains a priority because it removes first-run security friction and enables a smoother release path.

License

MIT © Si Hyeong Lee