Hugging Face's logo

smlflg
/
CodexDashBoard

Model card Files
xet
 Community
CodexDashBoard / README.md
smlflg's picture
smlflg
Initial public upload from Projekte/CodexDashBoard
981aa5d verified
preview code
|
Raw History Blame Contribute Delete
1.29 kB

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.