hai

# hai

> Say hi to AI, right from your terminal

[![npm version](https://img.shields.io/npm/v/%40aiany%2Fhai?style=flat)](https://www.npmjs.org/package/@aiany/hai)
[![License: GPL-3.0](https://img.shields.io/badge/License-GPL%203.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

**hai** (pronounced "hi") brings AI to your terminal. Run commands or ask questions—just hai it.

```bash
$ hai how much disk space
# → runs `df -h`, explains the result

$ hai what is Docker
# → answers your question directly
```

No complex setup. No switching modes. No quotes needed. Just describe what you need.

## Features

- **Agent Mode** - AI automatically executes shell commands based on your intent
- **Multiple AI Providers** - OpenAI, Anthropic Claude, Google DeepSeek, and any OpenAI-compatible API
- **Profile Management** - Configure multiple profiles for different models and providers
- **Interactive Mode** - Multi-turn conversations in the terminal
- **Pipe Support** - Process input from stdin or files
- **Predefined Prompts** - Create reusable prompt templates with `{{input}}` placeholder
- **Thinking Mode** - Enable extended thinking for supported models (DeepSeek, o1/o3)
- **Streaming Output** - Real-time response streaming with color support
- **Keyboard Shortcuts** - Interrupt output with ESC or Ctrl+C

## Installation

```bash
npm install -g @aiany/hai
```

## Usage

### Basic

```bash
# Single question (quotes optional)
hai What is the capital of France
hai "What is the capital of France?"

# Interactive mode
hai -i

# Interactive mode with initial message
hai -i Hello
```

> **Note:** Shell special characters like `?`, `*`, `!` require quotes or escaping.
> Use `hai "who are you?"` or `hai who are you\?`

### Agent Mode

By default, hai runs in agent mode where AI can execute shell commands to help you:

```bash
# AI will run `ls -la` to answer
hai "What files are in this directory?"

# AI will check git status and logs
hai Show me recent changes in this project

# AI wil