devcli-dashboard 0.1.0

A plugin-driven developer CLI with a live Textual dashboard.

DevCLI

DevCLI is a plugin-driven command line toolkit with a live Textual dashboard for developers and sysadmins.

It combines system metrics, task status, and dynamic plugins into a single terminal UI, making it easy to extend with custom monitoring, git status, and tooling panels.

Features

• Plugin-based dashboard architecture
• Live updates for system stats, git status, ping, and quotes
• Textual-powered terminal UI with left/right layout
• Easy plugin registration via register(tui_app) hooks
• CLI entrypoint via devcli

Installation

Install from PyPI once published:

pip install devcli

For local development:

python3 -m pip install -e .

Usage

Run the dashboard from the repository or installed package:

python3 -m devcli.main start

or if the package is installed:

devcli start

Plugin System

The dashboard is built around plugins located in devcli/plugins/.

Each plugin should expose a register(tui_app) function that appends a widget to tui_app.tui_panels.

Example plugin characteristics:

• cpu_temp.py — CPU temperature and frequency
• git_status.py — current git repo status
• ping_monitor.py — ping latency reporting
• fun_quotes.py — rotating motivational quotes

Creating a plugin

1. Add a new file under devcli/plugins/.
2. Define a Static-based widget.
3. Implement register(tui_app) and append the widget to tui_app.tui_panels.

Packaging for PyPI

This project is configured with pyproject.toml and uses setuptools for packaging.

Build and publish

python3 -m pip install build twine
python3 -m build
python3 -m twine upload dist/*

Development dependencies

Install development tooling:

python3 -m pip install -e .[dev]

Notes

• Requires Python 3.11+
• Depends on textual for the TUI
• python-dotenv is included for environment configuration support

Contribution

Contributions are welcome. Add new plugins, improve dashboard styling, or extend the CLI commands.