aichat

Ask a question

$ aichat "[explain quicksort]"

$ cat [file.py] | aichat "[review this code]"

$ aichat --model [claude:claude-sonnet-4-20250514] "[question]"

$ aichat -e "[list large files in current directory]"

$ aichat -i

$ aichat --role [shell] "[find duplicate files]"

$ aichat --file [document.pdf] "[summarize this]"

aichat [options] [prompt]

aichat is an all-in-one AI CLI tool supporting chat, command execution, and RAG (Retrieval-Augmented Generation). It works with 20+ AI providers including OpenAI, Claude, Gemini, Ollama, Azure, and many more.
In chat mode, it provides a REPL with conversation history, multi-line input, and syntax highlighting. Execute mode translates natural language descriptions into shell commands and optionally runs them. RAG mode indexes documents for question-answering over local files.
Roles define reusable personas and system prompts. Built-in roles include coder, shell, and translator. Custom roles are defined in the configuration file.
The tool supports function calling, allowing AI models to invoke defined tools. Sessions persist conversations across invocations. Multiple providers and models can be configured simultaneously.
Install via `cargo install aichat`, Homebrew, or download binaries.

-m, --model MODEL

Model to use (provider:model format).

Use a predefined role/persona.

Execute mode: translate natural language to shell commands.

Start interactive chat REPL.

Include file in the conversation.

Wrap output at column width.

Disable syntax highlighting.

Disable streaming output.

List available models.

List available roles.

Show current configuration.

API keys required for cloud providers. Configuration file needed for multi-provider setup. RAG indexing requires additional setup. Token usage and costs vary by provider and model.

aichat was created by sigoden in 2023 as a unified CLI for interacting with multiple AI providers. It grew from a simple chat tool into a comprehensive AI terminal toolkit with execute mode, RAG, and agent capabilities.

mods(1), smartcat(1), ollama(1), llm(1)