AI-Powered Terminal Assistant

Say hi to your shell

Bridge the gap between "what I want to do" and "how do I write that command?" with an intelligent terminal assistant that translates natural language into executable bash commands.

Get Started View on GitHub

Safe by default

Runs locally

Lightning fast

hi-shell

❯ hi-shell

Powerful Features

Whether you're a terminal veteran or a newcomer, hi-shell provides a fast, AI-powered way to generate and execute commands safely.

Embedded Models

Run models locally using candle with hardware acceleration (Metal/CUDA). Supports Llama, Phi-3, and Qwen2 architectures.

Local LLM Support

Connect to your own Ollama or LM Studio instance for complete privacy and control.

Cloud Integration

Seamless integration with OpenRouter, Gemini, and Anthropic for powerful cloud-based models.

Interactive REPL

A dedicated shell environment for continuous assistance and iterative command building.

Safety First

Dangerous commands are flagged, and confirmation is required before execution. Your system stays safe.

Lightning Fast

Optimized for speed with hardware acceleration support. Get your commands in milliseconds.

Installation

Choose your preferred installation method. We detect your operating system automatically.

Detected: 🍏 macOS

Supported: 🍏 macOS🐧 Linux

curl -sSL https://raw.githubusercontent.com/tufantunc/hi-shell/main/install.sh | bash

Supported: 🍏 macOS🐧 Linux

brew tap tufantunc/tap && brew install hi-shell

Supported: 🪟 Windows

⚠️ This method is not available for your system (macOS)

scoop bucket add hi-shell https://github.com/tufantunc/scoop-bucket && scoop install hi-shell

Supported: 🍏 macOS🐧 Linux🪟 Windows

cargo install hi-shell

After Installation

Run the initialization command to set up your preferred LLM provider:

hi-shell --init

Usage Examples

Just prefix your natural language request with hi-shell and let the magic happen.

One-shot Mode

Get quick answers directly from your command line. Just describe what you want to do in natural language and get the exact command you need.

One-shot Mode

Interactive REPL Mode

Start a dedicated shell environment for continuous assistance. The context is preserved between commands, so you can refine your requests naturally like a conversation.

Interactive Mode

Safety First

Dangerous commands are automatically detected and flagged with a warning. Confirmation is always required before execution, keeping your system safe.

Safety Features

Ready to say hi?

Stop searching for commands. Start describing what you want to do.

Install hi-shell Star on GitHub