harshal 0.1.0__tar.gz

harshal-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harshal Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

harshal-0.1.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: harshal
+Version: 0.1.0
+Summary: A multi-personality, feature-rich companion CLI helper tool
+Project-URL: Homepage, https://github.com/YOUR_USERNAME/harshal
+Project-URL: Bug Tracker, https://github.com/YOUR_USERNAME/harshal/issues
+Project-URL: Source, https://github.com/YOUR_USERNAME/harshal
+Author-email: Harshal <your@email.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,cli,productivity,rich,terminal,tui,typer
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Terminals
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: rich>=14.0
+Requires-Dist: textual>=0.75.0
+Requires-Dist: typer[all]>=0.15
+Provides-Extra: ai
+Requires-Dist: litellm>=1.40; extra == 'ai'
+Provides-Extra: full
+Requires-Dist: chime>=0.7; extra == 'full'
+Requires-Dist: litellm>=1.40; extra == 'full'
+Requires-Dist: psutil>=6.0; extra == 'full'
+Requires-Dist: pyperclip>=1.9; extra == 'full'
+Provides-Extra: notifications
+Requires-Dist: chime>=0.7; extra == 'notifications'
+Provides-Extra: system
+Requires-Dist: psutil>=6.0; extra == 'system'
+Requires-Dist: pyperclip>=1.9; extra == 'system'
+Description-Content-Type: text/markdown
+
+# Harshal CLI 🚀
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Support](https://img.shields.io/badge/python->=3.10-blue.svg)](https://www.python.org/)
+
+**Harshal CLI** is a highly interactive, customizable, and feature-rich terminal companion tool. From displaying system stats and system alerts to generating AI prompts and offering motivational quotes, Harshal adapts to your style with custom visual themes, interactive shells, and dynamic personalities.
+
+---
+
+## Features ✨
+
+* **Multiple Personalities**: Switch between `fun`, `serious`, `cyber`, and `cute` modes.
+* **Interactive Prompts**: Built on `prompt-toolkit` and styled with `rich` for elegant user feedback.
+* **System Utilities**: Copy output to clipboard, get performance statistics, and run system tasks.
+* **AI Engine Integration**: Integrated with `litellm` for direct interaction with LLMs.
+* **Curated Data Assets**: Local stores of quotes, fortunes, dad jokes, and retro ASCII art.
+
+---
+
+## Installation 📦
+
+You can install Harshal CLI using `pip` or `pipx`:
+
+```bash
+# Basic installation (includes UI, Core, and CLI shell)
+pip install .
+
+# Install with AI features (litellm)
+pip install ".[ai]"
+
+# Install with System utilities (psutil, pyperclip)
+pip install ".[system]"
+
+# Install with Notification sounds (chime)
+pip install ".[notifications]"
+
+# Install all features
+pip install ".[full]"
+```
+
+---
+
+## Commands and Usage 🛠️
+
+Once installed, use the CLI via the `harshal` entrypoint:
+
+```bash
+# Check version and verify install
+harshal --version
+
+# Run the main interactive prompt
+harshal run
+
+# Show a random curated quote
+harshal quote
+
+# Crack a hilarious dad joke
+harshal joke
+
+# Crack open a virtual fortune cookie
+harshal fortune
+
+# Print beautiful retro ASCII drawings
+harshal ascii --name computer
+```
+
+### Options
+
+* `--personality` (`-p`): Set the theme to `fun`, `serious`, `cyber`, or `cute`.
+* `--version`: Show version and exit.
+
+---
+
+## Personalities & Themes 🎨
+
+Harshal comes loaded with four pre-configured themes defined in `src/harshal/data/personality.toml`:
+
+1. 🎉 **Fun & Playful** (`fun`): Full of emojis, programmer jokes, and highly excited prompts.
+2. 💼 **Professional & Stoic** (`serious`): Direct, concise, objective, and stoic.
+3. 💻 **Cyberpunk Hacker** (`cyber`): Neon-green cyberpunk theme talking in terminal nodes and decrypt payloads.
+4. 🌸 **Cute & Cozy** (`cute`): Gentle, cozy, supportive text-emoticons `(* ^ ω ^)` and pastel magenta palettes.
+
+---
+
+## Project Structure 📁
+
+```text
+harshal/
+├── pyproject.toml
+├── LICENSE
+├── README.md
+└── src/
+    └── harshal/
+        ├── __init__.py
+        ├── cli.py            # CLI entrypoint and commands
+        ├── core/             # Core settings and state loaders
+        ├── commands/         # Subcommand implementation modules
+        ├── ui/               # Terminal styling and layout components
+        └── data/             # Local JSON & TOML static data files
+            ├── ascii_art.json
+            ├── dad_jokes.json
+            ├── fortunes.json
+            ├── personality.toml
+            └── quotes.json
+```
+
+---
+
+## License 📄
+
+This project is licensed under the MIT License - see the [LICENSE](file:///c:/work/Pypi/harshal/LICENSE) file for details.

harshal-0.1.0/README.md

@@ -0,0 +1,111 @@
+# Harshal CLI 🚀
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Support](https://img.shields.io/badge/python->=3.10-blue.svg)](https://www.python.org/)
+
+**Harshal CLI** is a highly interactive, customizable, and feature-rich terminal companion tool. From displaying system stats and system alerts to generating AI prompts and offering motivational quotes, Harshal adapts to your style with custom visual themes, interactive shells, and dynamic personalities.
+
+---
+
+## Features ✨
+
+* **Multiple Personalities**: Switch between `fun`, `serious`, `cyber`, and `cute` modes.
+* **Interactive Prompts**: Built on `prompt-toolkit` and styled with `rich` for elegant user feedback.
+* **System Utilities**: Copy output to clipboard, get performance statistics, and run system tasks.
+* **AI Engine Integration**: Integrated with `litellm` for direct interaction with LLMs.
+* **Curated Data Assets**: Local stores of quotes, fortunes, dad jokes, and retro ASCII art.
+
+---
+
+## Installation 📦
+
+You can install Harshal CLI using `pip` or `pipx`:
+
+```bash
+# Basic installation (includes UI, Core, and CLI shell)
+pip install .
+
+# Install with AI features (litellm)
+pip install ".[ai]"
+
+# Install with System utilities (psutil, pyperclip)
+pip install ".[system]"
+
+# Install with Notification sounds (chime)
+pip install ".[notifications]"
+
+# Install all features
+pip install ".[full]"
+```
+
+---
+
+## Commands and Usage 🛠️
+
+Once installed, use the CLI via the `harshal` entrypoint:
+
+```bash
+# Check version and verify install
+harshal --version
+
+# Run the main interactive prompt
+harshal run
+
+# Show a random curated quote
+harshal quote
+
+# Crack a hilarious dad joke
+harshal joke
+
+# Crack open a virtual fortune cookie
+harshal fortune
+
+# Print beautiful retro ASCII drawings
+harshal ascii --name computer
+```
+
+### Options
+
+* `--personality` (`-p`): Set the theme to `fun`, `serious`, `cyber`, or `cute`.
+* `--version`: Show version and exit.
+
+---
+
+## Personalities & Themes 🎨
+
+Harshal comes loaded with four pre-configured themes defined in `src/harshal/data/personality.toml`:
+
+1. 🎉 **Fun & Playful** (`fun`): Full of emojis, programmer jokes, and highly excited prompts.
+2. 💼 **Professional & Stoic** (`serious`): Direct, concise, objective, and stoic.
+3. 💻 **Cyberpunk Hacker** (`cyber`): Neon-green cyberpunk theme talking in terminal nodes and decrypt payloads.
+4. 🌸 **Cute & Cozy** (`cute`): Gentle, cozy, supportive text-emoticons `(* ^ ω ^)` and pastel magenta palettes.
+
+---
+
+## Project Structure 📁
+
+```text
+harshal/
+├── pyproject.toml
+├── LICENSE
+├── README.md
+└── src/
+    └── harshal/
+        ├── __init__.py
+        ├── cli.py            # CLI entrypoint and commands
+        ├── core/             # Core settings and state loaders
+        ├── commands/         # Subcommand implementation modules
+        ├── ui/               # Terminal styling and layout components
+        └── data/             # Local JSON & TOML static data files
+            ├── ascii_art.json
+            ├── dad_jokes.json
+            ├── fortunes.json
+            ├── personality.toml
+            └── quotes.json
+```
+
+---
+
+## License 📄
+
+This project is licensed under the MIT License - see the [LICENSE](file:///c:/work/Pypi/harshal/LICENSE) file for details.

harshal-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "harshal"
+version = "0.1.0"
+description = "A multi-personality, feature-rich companion CLI helper tool"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Harshal", email = "your@email.com"}
+]
+keywords = ["cli", "terminal", "ai", "productivity", "tui", "rich", "typer"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Utilities",
+    "Topic :: Terminals",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "typer[all]>=0.15",
+    "rich>=14.0",
+    "platformdirs>=4.0",
+    "prompt-toolkit>=3.0",
+    "textual>=0.75.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/YOUR_USERNAME/harshal"
+"Bug Tracker" = "https://github.com/YOUR_USERNAME/harshal/issues"
+"Source" = "https://github.com/YOUR_USERNAME/harshal"
+
+[project.optional-dependencies]
+ai = [
+    "litellm>=1.40",
+]
+system = [
+    "psutil>=6.0",
+    "pyperclip>=1.9",
+]
+notifications = [
+    "chime>=0.7",
+]
+full = [
+    "harshal[ai,system,notifications]",
+]
+
+[project.scripts]
+harshal = "harshal.cli:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/harshal"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/harshal/**/*.py",
+    "src/harshal/**/*.json",
+    "src/harshal/**/*.toml",
+    "src/harshal/**/*.tcss",
+    "README.md",
+    "LICENSE",
+    "pyproject.toml"
+]

harshal-0.1.0/src/harshal/__init__.py

@@ -0,0 +1,2 @@
+# harshal package initializer
+__version__ = "0.1.0"

harshal-0.1.0/src/harshal/cli.py

@@ -0,0 +1,242 @@
+import sys
+try:
+    sys.stdout.reconfigure(errors="replace")
+    sys.stderr.reconfigure(errors="replace")
+except Exception:
+    pass
+
+import typer
+from harshal.core.database import init_db
+from harshal.commands import (
+    ai, config_cmd, todo, notes, timer, morning, joy,
+    weather, system_cmd, random_cmd, search, git_cmd,
+    dev_tools, summary, creative, gamification, share, agent, safe_cmd
+)
+
+app = typer.Typer(name="harshal", help="Harshal CLI: Your AI-powered Terminal Companion")
+
+@app.callback(invoke_without_command=True)
+def main(ctx: typer.Context):
+    """
+    Initialize database and run Harshal CLI.
+    """
+    # Ensure database is initialized before any command runs
+    init_db()
+    if ctx.invoked_subcommand is None:
+        # Launch fullscreen TUI by default if terminal supports it
+        import sys
+        if sys.stdout.isatty():
+            try:
+                from harshal.ui.tui import HarshalTUIApp
+                tui_app = HarshalTUIApp()
+                tui_app.run()
+                return
+            except Exception:
+                pass
+
+        from harshal.ui.console import console
+        from rich.panel import Panel
+        from rich.align import Align
+        
+        # Beautiful ASCII art logo
+        welcome_logo = (
+            " █    █  █████  ████   █████  █   █  █████  █     \n"
+            " █    █  █   █  █   █  █      █   █  █   █  █     \n"
+            " ██████  █████  ████   █████  █████  █████  █     \n"
+            " █    █  █   █  █ █        █  █   █  █   █  █     \n"
+            " █    █  █   █  █  ██  █████  █   █  █   █  █████ \n"
+        )
+        
+        console.print()
+        console.print(Panel(
+            Align.center(
+                f"[primary]{welcome_logo}[/primary]\n"
+                f"[bold secondary]✨ Your Joyful AI-Powered Terminal Productivity Companion ✨[/bold secondary]\n\n"
+                f"[muted]Try running[/muted] [bold info]harshal dashboard[/bold info] [muted]or[/muted] [bold info]harshal chat[/bold info] [muted]to get started![/muted]"
+            ),
+            border_style="primary",
+            expand=False,
+            padding=(1, 4)
+        ))
+        console.print()
+        
+        # Show help
+        console_help = ctx.get_help()
+        console.print(console_help)
+
+@app.command("dashboard", help="Start the interactive fullscreen TUI dashboard environment")
+def start_tui():
+    """
+    Launch the fullscreen console dashboard window.
+    """
+    from harshal.ui.tui import HarshalTUIApp
+    tui_app = HarshalTUIApp()
+    tui_app.run()
+
+@app.command("play", help="Launch the Retro Arcade Hub (Snake, Typist, Memory Match)")
+def start_game():
+    """
+    Launch the Retro Arcade Hub with three games:
+    Task Snake, Code Speed Typist, and Syntax Memory Match.
+    """
+    import pathlib
+    from textual.app import App, ComposeResult
+    from harshal.ui.tui_screens.game import GameScreen
+
+    _CSS = pathlib.Path(__file__).parent / "ui" / "tui.tcss"
+
+    class GameOnlyApp(App):
+        CSS_PATH = str(_CSS)
+
+        def compose(self) -> ComposeResult:
+            yield GameScreen()
+
+    GameOnlyApp().run()
+
+@app.command("bootstrap", help="Setup and configure system executable environment paths and shell integration")
+def run_bootstrap():
+    """
+    Setup and configure system executable environment paths and shell integration.
+    """
+    from harshal.core.installer import bootstrap_paths
+    bootstrap_paths()
+
+# Register command modules as Typer sub-apps
+app.add_typer(ai.app, name="ai", help="Interact with the AI assistant (chat, ask questions, explain logs)")
+app.add_typer(config_cmd.app, name="config", help="Manage configuration settings and API keys interactively")
+app.add_typer(todo.app, name="todo", help="Manage tasks, streaks, priorities, and checkoff lists")
+app.add_typer(notes.app, name="notes", help="Manage notes, tags, and retro dev journaling logs")
+app.add_typer(timer.app, name="timer", help="Run Pomodoro focus sessions and automated desktop breaks")
+app.add_typer(joy.app, name="joy", help="Delight tools (developer humor, digital fortune cookies, celebrations)")
+app.add_typer(weather.app, name="weather", help="Get weather conditions and humorous AI comments")
+app.add_typer(system_cmd.app, name="system", help="Gather local hardware specs & real-time resource loads instantly")
+app.add_typer(random_cmd.app, name="random", help="Generate secure passwords, UUIDs, developer excuses, or lorem ipsum")
+app.add_typer(search.app, name="search", help="Perform quick web searches and extract summaries from pages")
+app.add_typer(git_cmd.app, name="git", help="Smart Git committing, diff analysis, and interactive Git Buddy helper")
+app.add_typer(dev_tools.app, name="dev", help="Developer workflow helper, regex maker, cheatsheets, and shell history debugs")
+app.add_typer(summary.app, name="summary", help="Summarize clipboard contents or target text file contents")
+app.add_typer(creative.app, name="creative", help="ASCII art generation, coding trivia, stories and playful roasts")
+app.add_typer(gamification.app, name="leveling", help="XP leveling progress dashboard, streaks, and achievements checklist")
+app.add_typer(share.app, name="share", help="Upload pastebin code snippets and generate terminal QR codes")
+app.add_typer(agent.app, name="agent", help="ReAct shell automation agent (caution: executes system shell tasks)")
+app.add_typer(safe_cmd.app, name="safe", help="Secure encrypted credentials vault (passwords, API keys, tokens)")
+
+# Root-level shortcut command registrations
+app.command("ask", help="Query Harshal AI directly")(ai.ask)
+app.command("chat", help="Start an interactive chat session with Harshal")(ai.chat)
+app.command("note", help="Quick shortcut to add a note")(notes.note)
+app.command("morning", help="Get your daily morning dashboard briefing")(morning.morning)
+app.command("pomodoro", help="Start a Pomodoro focus session")(timer.pomodoro)
+
+# Joy shortcut command registrations
+app.command("inspire", help="Show an inspiring quote or a developer joke")(joy.inspire)
+app.command("fortune", help="Open a digital fortune cookie")(joy.fortune)
+app.command("celebrate", help="Trigger a custom celebration burst")(joy.celebrate)
+
+# Dev tools shortcut command registrations
+app.command("oops", help="Explain last failed shell command error and suggest fix")(dev_tools.oops)
+app.command("vibecheck", help="Check developer frustration vibe from shell history")(dev_tools.vibecheck)
+app.command("cheat", help="Generate cheatsheet for a programming topic")(dev_tools.cheat)
+app.command("regex", help="Generate a regular expression from natural language description")(dev_tools.regex)
+app.command("codegraph", help="Generate a structure graph of the codebase using graphifyy for AI coding agents")(dev_tools.codegraph)
+app.command("systema", help="Run AI diagnostics and optimization analysis on systemspecs")(system_cmd.systema)
+app.command("gitbuddy", help="Direct shortcut to launch the interactive Git Buddy assistant")(git_cmd.buddy)
+
+@app.command("guide", help="Show the ultimate interactive cheatsheet and user guide for Harshal")
+def show_guide():
+    """
+    Display a beautifully formatted, categorized cheat sheet of all available commands,
+    TUI keyboard shortcuts, and helpful tips.
+    """
+    from rich.panel import Panel
+    from rich.table import Table
+    from harshal.ui.console import console
+    
+    welcome = (
+        "📖 [bold primary]Harshal Interactive User Guide & Cheatsheet[/bold primary]\n"
+        "[dim]Get the most out of your AI-powered terminal productivity companion.[/dim]"
+    )
+    console.print(Panel(welcome, border_style="primary"))
+    
+    # 1. Command Categories Table
+    table = Table(title="Command Directory by Category", border_style="cyan", show_header=True)
+    table.add_column("Category", style="bold cyan", width=25)
+    table.add_column("Commands", style="green", width=30)
+    table.add_column("Description / Example", style="dim")
+    
+    table.add_row(
+        "🤖 AI Companion",
+        "harshal chat\nharshal ask <query>\nharshal agent",
+        "Interactive TUI chat session\nDirect terminal Q&A\nStep-by-step ReAct shell executor"
+    )
+    table.add_row(
+        "⚙️ System & Dev Tools",
+        "harshal system\nharshal systema\nharshal oops\nharshal vibecheck",
+        "Local hardware spec & resource load\nAI-powered bottleneck analysis report\nAnalyze last failed command error & get fix\nFrustration vibe scanner from shell history"
+    )
+    table.add_row(
+        "🐙 Smart Git",
+        "harshal git\nharshal gitbuddy\nharshal git status\nharshal git smart-commit",
+        "Launches the interactive Git Buddy assistant\nDirect shortcut to Git Buddy\nCustom colorized repository status\nAI-generated conventional commits"
+    )
+    table.add_row(
+        "📝 Productivity & Focus",
+        "harshal todo\nharshal notes\nharshal timer\nharshal morning",
+        "Manage tasks, streaks, and priorities\nMarkdown-enabled notes & journaling\nPomodoro focus timers & break logs\nInteractive daily Briefing dashboard"
+    )
+    table.add_row(
+        "🎉 Delight & Utility",
+        "harshal inspire\nharshal fortune\nharshal weather\nharshal search <query>",
+        "Inspiring developer quotes & jokes\nDigital fortune cookies\nWeather updates with AI comments\nFast web search & article summaries"
+    )
+    table.add_row(
+        "🎲 Random Generators",
+        "harshal random\nharshal random 32\nharshal random password\nharshal random uuid\nharshal random excuse\nharshal random lorem",
+        "Random 10-char alphanumeric string (default)\nRandom string of given length (< 1000)\nSecure password generator\nCryptographic v4 UUID generator\nFunny developer excuses (AI or local)\nDummy Lorem Ipsum generator"
+    )
+    table.add_row(
+        "🔐 Credentials Safe",
+        "harshal safe\nharshal safe store\nharshal safe get <name>\nharshal safe list\nharshal safe delete <name>",
+        "List all stored credentials\nInteractively store a new credential\nDecrypt & retrieve a credential (clipboard)\nList names and types\nPermanently delete a credential"
+    )
+    
+    console.print(table)
+    console.print()
+    
+    # 2. TUI Keyboard Shortcuts Panel
+    tui_shortcuts = (
+        "[bold accent]Universal Navigation & Shortcuts (in TUI Dashboard):[/bold accent]\n"
+        "  • [info]Ctrl+D[/info] : Open Dashboard Tab      "
+        "  • [info]Ctrl+C[/info] : Open AI Chat Tab\n"
+        "  • [info]Ctrl+T[/info] : Open Todo List Tab      "
+        "  • [info]Ctrl+N[/info] : Open Notes Tab\n"
+        "  • [info]Ctrl+P[/info] : Open Pomodoro Timer Tab "
+        "  • [info]Ctrl+G[/info] : Open Arcade Snake Game\n"
+        "  • [info]Ctrl+S[/info] : Open System Matrix Tab  "
+        "  • [info]Ctrl+O[/info] : Open Settings Panel\n"
+        "  • [info]Ctrl+Q[/info] : Quit Dashboard\n\n"
+        "[bold secondary]Contextual Keyboard Actions (Ctrl+K):[/bold secondary]\n"
+        "  • [info]Notes/Journal[/info] : Save current note / toggle preview\n"
+        "  • [info]Todo Screen[/info]   : Save new task\n"
+        "  • [info]Focus Timer[/info]   : Play / pause Pomodoro\n"
+        "  • [info]Arcade Game[/info]   : Play / pause Snake game\n"
+    )
+    console.print(Panel(tui_shortcuts, title="🖥️ Full Screen Dashboard TUI Keyboard Guide", border_style="accent"))
+    console.print()
+    
+    # 3. AI Providers & Models
+    ai_info = (
+        "[bold info]Configure AI Providers & Keys:[/bold info]\n"
+        "  Run [bold]harshal config setup[/bold] to configure your active LLM provider and credentials.\n"
+        "  Supports: Google Gemini, OpenAI, Anthropic, Groq (Fast LPU), and Ollama (Local/Offline).\n\n"
+        "[bold secondary]TUI Inline Slash Commands (typed in Chat Input):[/bold secondary]\n"
+        "  • [info]/model <name>[/info]    : Switch model on the fly\n"
+        "  • [info]/provider <name>[/info] : Switch active provider on the fly\n"
+        "  • [info]/theme <name>[/info]    : Change companion personality theme\n"
+        "  • [info]/clear[/info]           : Clear current message thread\n"
+        "  • [info]/help[/info]            : Show inline chat helper"
+    )
+    console.print(Panel(ai_info, title="🤖 AI Configuration & Chat Guide", border_style="secondary"))
+
+if __name__ == "__main__":
+    app()

harshal-0.1.0/src/harshal/commands/__init__.py

@@ -0,0 +1,5 @@
+"""
+CLI commands and subcommands.
+"""
+
+__version__ = "0.1.0"