harshal 2.1.0

AI-powered Terminal Productivity Companion with Glow Notes + LazyVim IDE

Harshal CLI

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

# 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
• 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

pip install .

Full Install (with all features)

pip install ".[full]"

Unified Installer (recommended)

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
• GitHub: github.com/harshal0704/harshal
• Issues: github.com/harshal0704/harshal/issues

---

License

MIT License - see LICENSE for details.