TermFlow
TermFlow is a production-grade, minimalist terminal productivity dashboard built entirely in Python using the Textual framework. Designed for developers and terminal enthusiasts, it provides a distraction-free environment to manage your time and tasks.
Features
- Live Dashboard: Real-time clock and date display.
- Task Management: Persistent todo list with colored tags (
[dev],[school],[life]). - Deep Work: Integrated Pomodoro timer with session tracking.
- Contextual Info: Live weather updates and motivational quotes.
- Keyboard-First: Optimized for speed with comprehensive keybindings.
- Lightweight & Portable: Zero bloat, file-based persistence, and low resource usage.
Installation
Ensure you have Python 3.8+ installed.
pip install textual requests
Usage
Launch the dashboard directly from your terminal:
python main.py
Keybindings
?: Toggle Help Overlayq: Quit ApplicationTab: Cycle focus between panelsEnter: Add todo / Toggle task statuss: Start/Pause Pomodoror: Reset Pomodoro
Axoninnoova: The Future of Automation
TermFlow is proud to be part of the Axoninnoova ecosystem. We believe in the power of automation and minimalist tooling to multiply human productivity. Our community is dedicated to building the next generation of developer tools that are fast, reliable, and stay out of your way.
Technical Details
TermFlow is a minimal terminal productivity dashboard built with Python and the Textual TUI framework. It provides a live, interactive terminal interface combining several productivity tools: a real-time clock, a persistent todo list, a Pomodoro timer, and an info panel displaying weather and motivational quotes.
The application is designed to run entirely in the terminal, offering a distraction-free productivity environment without needing a web browser or GUI.
System Architecture
- Framework: Textual (Python TUI framework built on Rich)
- Layout: Grid-based panel system with four main components
- Styling: Custom TCSS stylesheet (
styles.tcss) - Data Storage: Simple JSON file (
todos.json) for persistence
Credits
- Atharv: Founder & Lead Architect.
- Axoninnoova Community: For the continuous feedback and support.
Join our community: https://dsc.gg/axoninnova
License
MIT © 2026 TermFlow
1 maintainer
Metadata
1 maintainer
Release files for termflow-cli 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| termflow_cli-0.1.4.tar.gz | 17.0 kB | Without provenance | Details for termflow_cli-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| termflow_cli-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for termflow_cli-0.1.4-py3-none-any.whl |
Total release size: 37.2 kB
Release files / termflow_cli-0.1.4.tar.gz
| Download URL | termflow_cli-0.1.4.tar.gz |
|---|---|
| Size | 17.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3913f2c0b84270bb57a4b92bb077ded8e9eb839094c66aecd89f82ff2cf16186
|
|
BLAKE2b-256 checksum How to use checksums |
1f48d628ff46c550b8f88e1f7fe1f356f6d657628c8eef46f29d9dc5522ccba3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Release files / termflow_cli-0.1.4-py3-none-any.whl
| Download URL | termflow_cli-0.1.4-py3-none-any.whl |
|---|---|
| Size | 20.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64ab433fcfa9c3fe061559a1951450c48d5c06742eaca4f4eca7014cd140e7d9
|
|
BLAKE2b-256 checksum How to use checksums |
d1f71d18d7e5808b992ffda9a31fb2e59ef1a346ec1ca5927fc1e4ede9b7c8f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.11
|
Security for termflow-cli 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
