⚡ FlowState CLI

FlowState is a modern, high-performance command-line interface (CLI) application designed to orchestrate daily tasks and habits directly from the terminal.

Engineered for speed and developer experience, it leverages Typer for robust command routing, Rich for beautiful, easily readable terminal UI, and uv for lightning-fast environment management.

🚀 Features

• Blazing Fast Execution: Built on modern Python standards using uv for dependency management.
• Rich Terminal UI: Color-coded outputs, structured tables, and clear visual feedback.
• Local JSON Data Persistence: Lightweight, portable, and secure local storage.
• Modular Architecture: Designed with strict separation of concerns (CLI routing vs. data management) to seamlessly accommodate future database and API integrations.

🛠️ Tech Stack

• Language: Python 3.10+
• CLI Framework: Typer
• Terminal UI: Rich
• Package Manager: uv

🗺️ Project Roadmap (Evolutionary Architecture)

This project is actively evolving. The current architecture serves as the robust foundation for a larger, AI-driven ecosystem:

• Phase 1: Core CLI, routing, data persistence, and terminal rendering.
• Phase 2: Relational SQLite storage layer and advanced task filtering.
• Phase 3: Integration of predictive analytics and habit tracking metrics.
• Phase 4: Collaborative Multi-Agent AI integration (LLM-powered task prioritization and workflow breakdown).

⚙️ Installation

To run this project locally, ensure you have Python and uv installed.

1. Clone the repository:

   git clone [https://github.com/yourusername/flowstate-cli.git](https://github.com/yourusername/flowstate-cli.git)
   cd flowstate-cli