# 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:

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

## Run

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

## Test

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

## Install As User Service

```bash
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`.