DevDash CLI

A terminal-based developer dashboard providing real-time visibility into git status, CI/CD pipelines, open PRs, and assigned issues. Built with Python and Textual for a modern, responsive TUI experience.

Features

• Git Repository Status - Display current branch, commit hash, uncommitted changes summary, and remote sync status
• CI/CD Pipeline Monitoring - Show running workflows, their status (pending/running/success/failure), duration, and recent runs
• Pull Request Tracker - List open PRs with status, checks, authors, and assignees. Show draft vs ready status
• Issue Overview - Display assigned issues with status, labels, and priority indicators
• Auto-Refresh - Automatically refresh data at configurable intervals (default 30s)
• Multi-Repository Support - Configure and switch between multiple repositories with saved settings
• GitHub Integration - Full API integration with GitHub for repos, PRs, issues, and workflows
• GitLab Integration - Full API integration with GitLab for repos, MRs, issues, and pipelines
• Keyboard Navigation - Full keyboard control for navigation, refresh, switching views, and actions
• Configuration Management - CLI-based configuration for API tokens, default repo, refresh interval

Installation

Prerequisites

• Python 3.10 or higher
• pip or poetry

Install from Source

git clone https://7000pct.gitea.bloupla.net/7000pctAUTO/devdash-cli.git
cd devdash-cli
pip install -e .

Install from PyPI

pip install devdash-cli

Configuration

Environment Variables

Create a .env file or set environment variables:

export GITHUB_TOKEN="your_github_token"
export GITLAB_TOKEN="your_gitlab_token"
export DEVDASH_REPO="owner/repo"
export DEVDASH_REFRESH=30
export DEVDASH_THEME=dark

CLI Configuration

devdash add-repo owner/repo --provider github
devdash add-repo owner/repo --provider gitlab
devdash config
devdash doctor

Usage

devdash                          # Launch with default repository
devdash launch owner/other-repo  # Launch with specific repository
devdash launch --refresh 60      # Set custom refresh interval
devdash launch --theme light     # Use light theme

Keyboard Shortcuts

Key	Action
q	Quit
r	Refresh data
j/k	Move up/down
h/l	Move left/right
1-4	Switch panels
Esc	Quit

API Setup

GitHub

1. Create a Personal Access Token at https://github.com/settings/tokens
2. Select scopes: repo, read:org
3. Set GITHUB_TOKEN environment variable

GitLab

1. Create a Personal Access Token at https://gitlab.com/-/user_settings/personal_access_tokens
2. Select scopes: api, read_api
3. Set GITLAB_TOKEN environment variable

Development

python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v
pytest tests/ --cov=src --cov-report=term-missing
ruff check src/

License

MIT License