CodexDashBoard

Lightweight native dashboard for Codex on Linux.

The goal is not to clone the existing Claude Code panel. This project keeps the surface small and stable:

• recent Codex threads from ~/.codex/state_5.sqlite
• Codex-related processes
• recent Codex logs
• quick actions for resume, open folder, refresh, and safe process stop

Current v0.2 scope is Codex-first. Unfinished Claude-specific views are not part of the shipped P0 UI.

GUI System Dependencies

On Ubuntu / Pop!_OS install the required GTK / GI development packages first:

sudo apt-get update
sudo apt-get install -y \
  libgirepository-2.0-dev \
  gobject-introspection \
  libgtk-3-dev \
  libcairo2-dev \
  pkg-config

Run

cd /home/smlflg/Projekte/CodexDashBoard
python3 -m pip install -e '.[gui]'
python3 -m codex_dashboard

Test

cd /home/smlflg/Projekte/CodexDashBoard
python3 -m pip install -e '.[dev]'
python3 -m pytest
python3 -m compileall src tests

Install As User Service

cp systemd/codex-dashboard.service ~/.config/systemd/user/
cp desktop/codex-dashboard.desktop ~/.local/share/applications/
systemctl --user daemon-reload
systemctl --user enable --now codex-dashboard.service

The app logs to ~/.cache/codex-dashboard.log.