dev-dashboard 0.1.0

Terminal Control Center for Developers

DEV Dashboard

Terminal Control Center for Developers

A modern terminal-based developer dashboard for monitoring repositories, Docker containers, GitHub activity, and system status — all from a clean interactive CLI interface.

Built with Python, Docker, and Textual.

---

Overview

DEV Dashboard is a lightweight terminal control center designed to give developers quick visibility into their development environment.

It provides a multi-page terminal UI for:

• Git repositories
• GitHub activity
• Docker containers
• System monitoring
• Developer workflow tools

All within a fast keyboard-driven interface.

---

Screenshot

DEV Dashboard running inside a terminal

System Stats GitHub Repositories Repo Activity Todo List Local Repos Activity Feed

Navigation pages:

1 Dashboard

2 Repositories

3 Docker

4 Logs

---

Features

System Monitoring

View system statistics directly inside the dashboard.

• CPU usage
• Memory usage
• Disk usage
• System overview panel

---

Git Repository Management

Browse and manage repositories stored in /projects.

Features include:

• View all local repositories
• Current branch display
• Last commit information
• Modified files detection
• Commits ahead of origin
• Pull repositories
• View commit history
• View repository status
• Clone new repositories

---

GitHub Integration

Integrates with the GitHub API to show recent activity.

Includes:

• Push events
• Pull requests
• Issues
• Repository stars
• Activity feed panel

Authentication via GitHub Personal Access Token.

---

Docker Monitoring

Manage Docker containers directly from the dashboard.

Features include:

• List all containers
• View running / stopped status
• Restart containers
• Stop containers
• View container logs
• Auto-refresh container status

---

Developer Workflow Tools

Panels designed to support development workflows:

• Todo list panel
• Repo activity panel
• Activity event feed
• Repository overview

---

Terminal UI

Powered by Textual for a modern terminal experience.

Features include:

• Interactive terminal UI
• Live updating panels
• Keyboard navigation
• Multi-page dashboard
• Lightweight design
• Clean green terminal theme

---

Each component is implemented as a modular Textual widget, making the dashboard easy to extend.

---

Requirements

• Python 3.11+
• Docker
• Git
• GitHub Personal Access Token (optional)

---

Installation

Quick Start (Recommended)

git clone https://github.com/jwestgarth/dev-dashboard.git
cd dev-dashboard
pip install -e .
dev-dashboard

---

Run with Docker

docker compose up -d
docker exec -it dev-dashboard python -m app.main

---

Configuration (Optional)

Create a .env file in the project root:

GITHUB_TOKEN=your_github_token
GITHUB_USER=your_github_username

Generate a GitHub token here:

https://github.com/settings/tokens

Recommended permissions:

read:user
repo

---

Requirements

• Python 3.11+
• Docker
• Git

---

Windows Notes (if dev-dashboard not found)

If PowerShell cannot find the dev-dashboard command, add the Python Scripts directory to your PATH:

C:\Users\<username>\AppData\Local\Python\pythoncore-3.14-64\Scripts

Restart PowerShell afterwards.

One-line install

git clone https://github.com/jwestgarth/dev-dashboard.git && cd dev-dashboard && pip install -e . && dev-dashboard

Configuration

Create a .env file in the project root.

GITHUB_TOKEN=your_github_token

GITHUB_USER=your_github_username

Generate a token here:

https://github.com/settings/tokens

Recommended permissions

read:user

repo

Run with Docker (Recommended)

Start the container:

docker compose up -d

Launch the dashboard:

docker exec -it dev-dashboard python -m app.main

Keyboard Shortcuts

Global Navigation

Key	Action
1	Dashboard
2	Repositories
3	Docker
4	Logs
q	Quit dashboard

Repository Controls

Key	Action
↑ ↓	Select repository
p	Pull repository
h	View commit history
s	Git status
c	Clone repository
ESC	Close output

Docker Controls

Key	Action
↑ ↓	Select container
l	View container logs
r	Restart container
s	Stop container
ESC	Close logs

License

MIT License

Author

Jack Westgarth

GitHub https://github.com/jwestgarth