Metadata-Version: 2.4
Name: harshal
Version: 2.1.0
Summary: AI-powered Terminal Productivity Companion with Glow Notes + LazyVim IDE
Project-URL: Homepage, https://harshalcli.vercel.app
Project-URL: Bug Tracker, https://github.com/harshal0704/harshal/issues
Project-URL: Source, https://github.com/harshal0704/harshal
Project-URL: Documentation, https://harshalcli.vercel.app
Author-email: Harshal <your@email.com>
License: MIT
License-File: LICENSE
Keywords: ai,cli,glow,ide,lazyvim,neovim,notes,productivity,rich,terminal,tui,typer
Classifier: Development Status :: 4 - Beta
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: pyyaml>=6.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/)
[![Website](https://img.shields.io/badge/Website-harshalcli.vercel.app-brightgreen.svg)](https://harshalcli.vercel.app)
[![GitHub](https://img.shields.io/badge/GitHub-harshal0704%2Fharshal-blue.svg)](https://github.com/harshal0704/harshal)

**Harshal CLI** is an AI-powered terminal productivity companion. Notes with Glow, IDE with LazyVim, Docker management with LazyDocker, AI chat, and 20+ tools — all from your terminal.

---

## Quick Start

```bash
# Install
pip install .

# Or use the unified installer (installs Glow, Neovim, LazyVim, everything)
python install.py

# Launch TUI dashboard
harshal

# Create your first note
harshal notes new

# Browse notes with Glow
harshal notes open

# Launch LazyVim IDE
harshal ide

# Manage Docker containers
harshal docker

# AI chat
harshal chat
```

---

## Features

- **Notes with Glow** — Markdown notes stored as `.md` files, rendered beautifully with [Glow](https://github.com/charmbracelet/glow)
- **LazyVim IDE** — Full Neovim IDE with LSP, Treesitter, Telescope, Git integration — auto-installs
- **LazyDocker** — Terminal UI for Docker container management
- **AI Chat** — Chat with AI using Gemini, OpenAI, Anthropic, Groq, or Ollama
- **Developer Tools** — Git buddy, cheatsheets, regex generator, shell history analysis
- **Productivity** — Todo list, Pomodoro timer, daily morning briefing
- **Fun** — Developer quotes, jokes, fortune cookies, ASCII art
- **Credentials Vault** — Encrypted password and API key storage
- **XP Leveling** — Gamification with XP, streaks, and achievements

---

## Commands

Run `harshal guide` after installation for the full command reference, or `harshal --help` for quick help.

### Notes & Glow
| Command | Description |
|---------|-------------|
| `harshal notes new` | Create a note interactively |
| `harshal notes add "text"` | Quick save a note |
| `harshal notes open` | Browse notes in Glow TUI |
| `harshal notes list` | List all notes |
| `harshal notes search <query>` | Search notes |
| `harshal notes install` | Install Glow renderer |
| `harshal notes journal` | AI-guided journaling |

### LazyVim IDE
| Command | Description |
|---------|-------------|
| `harshal ide` | Launch LazyVim (auto-installs) |
| `harshal ide install` | Install LazyVim config |
| `harshal ide update` | Update LazyVim plugins |
| `harshal ide status` | Check IDE status |

### Docker
| Command | Description |
|---------|-------------|
| `harshal docker` | Launch LazyDocker |
| `harshal docker install` | Install LazyDocker |
| `harshal docker status` | Check Docker status |

### AI
| Command | Description |
|---------|-------------|
| `harshal chat` | Interactive AI chat |
| `harshal ask "question"` | Direct AI question |
| `harshal config setup` | Configure AI provider |

---

## Installation

### Quick Install
```bash
pip install .
```

### Full Install (with all features)
```bash
pip install ".[full]"
```

### Unified Installer (recommended)
```bash
python install.py
```
This auto-installs Glow, Neovim + LazyVim, and bootstraps everything for your OS (Windows, macOS, Linux).

---

## Requirements

- Python >= 3.10
- Glow (auto-installed by `python install.py`)
- Neovim >= 0.11 (optional, for `harshal ide`)
- Docker (optional, for `harshal docker`)

---

## Links

- **Website:** [harshalcli.vercel.app](https://harshalcli.vercel.app)
- **GitHub:** [github.com/harshal0704/harshal](https://github.com/harshal0704/harshal)
- **Issues:** [github.com/harshal0704/harshal/issues](https://github.com/harshal0704/harshal/issues)

---

## License

MIT License - see [LICENSE](LICENSE) for details.
