Agent Deck is a read-only macOS dashboard that brings your Codex, Claude, and Cursor activity into one place.
Agent Deck is an independent source project. It is not affiliated with, endorsed by, or sponsored by OpenAI, Anthropic, Anysphere, GitHub, or Corsair.
It was built specifically for the CORSAIR XENEON EDGE 14.5-inch LCD touchscreen. The display’s native 2560 × 720, 32:9 canvas shaped Agent Deck’s three-pane layout and touch-friendly sizing.
Codex, Claude, and Cursor each keep their conversations and usage information in a different place. Agent Deck turns those separate sources into a single, glanceable workspace.
The app is designed to stay open beside your main display or on a dedicated touchscreen. At a glance, you can see which agents are working, which sessions need attention, what happened in the selected conversation, and how much of each subscription quota you have used.
Agent Deck is intentionally passive. It does not create sessions, send prompts, resume work, or change provider settings.
- Recent Codex, Claude, and Cursor sessions in one unified list.
- Working, waiting, completed, and attention-required states.
- The selected conversation’s summary, recent events, model, branch, duration, and token count.
- Available plan limits, reset times, credits, and usage measurements.
- Provider availability and partial-data warnings.
- Automatic refresh every 15 seconds without interrupting the interface.
On narrower displays, Agent Deck keeps sessions and usage visible while opening conversation details in a slide-over panel.
The interface follows your light or dark system appearance and supports English and French. A manual language choice is stored locally.
Agent Deck has no account system and no dedicated cloud service. Its Rust adapters read the files and authenticated sessions already created by the installed desktop applications.
| Provider | Conversations | Usage |
|---|---|---|
| Codex | ~/.codex/state_5.sqlite and JSONL rollouts |
The codex app-server bundled with the Codex app |
| Claude | ~/.claude/projects and Claude Desktop session metadata |
Local usage history and the Anthropic OAuth usage endpoint when available |
| Cursor | Cursor’s local state.vscdb database |
Cursor’s usage summary using the existing local session |
Local databases are opened in read-only mode. Conversation titles, summaries, activity, project names, and usage measurements are serialized to the local Vue interface for display. Credentials and tokens remain in the Rust backend and are never serialized to Vue or written by Agent Deck.
These local formats are implementation details rather than stable public APIs. Updates to Codex, Claude, or Cursor may require adapter changes.
Agent Deck has no dedicated cloud service and does not upload conversations to an Agent Deck server. The Rust backend makes these authenticated requests only to retrieve account and quota information:
| Provider | Destination | Purpose |
|---|---|---|
| Codex | The local codex app-server process |
Read the authenticated account and rate limits. The Codex process manages its own provider connection. |
| Claude | https://api.anthropic.com/api/oauth/usage |
Read OAuth usage windows when local credentials are available. |
| Cursor | https://cursor.com/api/usage-summary and https://cursor.com/api/auth/me |
Read plan usage and account metadata using the existing local session. |
The About panel can open allow-listed GitHub, Enchanter, and Corsair pages after you select their links. The Vue frontend cannot initiate arbitrary external connections.
Agent Deck does not provide an official downloadable binary. Build and run it from source. The current release is tested on Apple Silicon; Intel Macs and other operating systems are not verified.
You need macOS, Node.js 22 or later, pnpm 10.33, a stable Rust toolchain, and at least one supported app that has already been used on the Mac.
git clone https://github.com/eMeRiKa13/agent-deck.git
cd agent-deck
pnpm install
pnpm dev:desktopTauri starts the frontend at http://127.0.0.1:1421 and opens the native macOS window. Agent Deck refreshes local sessions every 15 seconds and usage quotas every 2 minutes. A manual refresh updates both immediately.
To work on the interface in a browser without reading local application data, run the demo adapter:
pnpm devAgent Deck uses Tauri 2 and Rust for local data access, with Vue 3, TypeScript, Vue I18n, Vite, and Tailwind CSS for the interface.
Run the frontend checks:
pnpm typecheck
pnpm test
pnpm buildRun the Rust checks:
PATH="$HOME/.cargo/bin:$PATH" cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
PATH="$HOME/.cargo/bin:$PATH" cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
PATH="$HOME/.cargo/bin:$PATH" cargo test --manifest-path src-tauri/Cargo.tomlBuild the desktop application:
pnpm build:desktopCargo keeps compiled dependencies and incremental build caches in src-tauri/target/.
The directory is ignored by Git and can be safely regenerated. If it grows
too large, reclaim the space with:
pnpm clean:rustDevelopment and test profiles keep line tables for useful Rust backtraces but
omit debug symbols from third-party dependencies to limit future growth. Use
CARGO_PROFILE_DEV_DEBUG=2 temporarily when a native debugging session needs
full symbols.
Smoke tests that inspect installed application data are ignored by default. Run them explicitly with:
PATH="$HOME/.cargo/bin:$PATH" cargo test --manifest-path src-tauri/Cargo.toml -- --ignoredsrc/ Vue interface and browser demo data
src/components/ Dashboard components
src/composables/ Polling and application state
src-tauri/src/providers Codex, Claude, and Cursor adapters
src-tauri/ Tauri configuration and Rust backend
Agent Deck runs locally. It does not upload conversations to an Agent Deck service or expose credentials collected by the provider adapters to the frontend.
Report security issues through the private process in SECURITY.md.
Agent Deck source code is available under the MIT License.
Third-party icons, names, and trademarks remain the property of their
respective owners; see THIRD_PARTY_NOTICES.md.
This repository is published as a showcase and does not currently accept
unsolicited issues or pull requests. See CONTRIBUTING.md.