A Terminal-Based Assistant for Generating Shell Commands
How-CLI is a terminal-based assistant that generates precise shell commands for any task you ask. Powered by Google Gemini’s generative AI, it provides context-aware, executable shell commands tailored to your current environment.
- Generate exact shell commands based on your current working directory, OS, and available tools.
- Context-aware: considers files, git repositories, shell type, and installed tools.
- Command history logging for easy reference.
- Clipboard support: copies generated commands automatically.
- Typewriter effect for visually appealing output (optional).
- Configurable Google Gemini API key.
- Handles API errors, content blocks, and timeouts gracefully.
Yeah, I know... It’s a Gemini wrapper.
I know it's not the next Warp AI terminal or some fancy LLM-based shell integration with auto-completion and context persistence...
I know it's “yet another CLI tool”
and yes, I'm painfully aware that wrapping an API and printing stuff in the terminal isn't groundbreaking computer science...
But here's the thing: I made How-CLI because it was fun and quick to build...
It's not meant to change the world. It’s meant to make typing "how to do X in bash" a little more amusing..
Think of it as a weekend hack.
pip install how-cli-assisthow.mp4
Open your terminal and try:
# Examples:
how to create a Python virtual environment
> python -m venv env
how to list all files modified in the last 7 days
> find . -type f -mtime -7
# Show your previous questions and commands
how --history
# Set or update your Google Gemini API key
how --api-key YOUR_GEMINI_API_KEY_HERE--silent : Suppress spinner and typewriter effect.
--type : Show output with typewriter effect.
--history : Display previous questions and generated commands.
--help : Show help message and exit.
--api-key <API_KEY> : Set or replace your Google Gemini API key.
This project is licensed under the MIT License. See the LICENSE file for details.