README中文

A CLI for AI/LLM chat in terminal

• written in rust, light (6.5MB binary size), super fast.

• multi platform(Windows, Linux, MacOS)

• using /v1/chat/completion API

aichat <INPUT MESSAGE>    

Quick Start

Installation

sh

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/slow-groovin/terminal-aichat/releases/latest/download/terminal-aichat-installer.sh | sh

cargo

cargo install terminal-aichat

homebrew

brew install slow-groovin/tap/terminal-aichat

npm

npm install terminal-aichat@latest

powershell

powershell -ExecutionPolicy Bypass -c "irm https://github.com/slow-groovin/terminal-aichat/releases/latest/download/terminal-aichat-installer.ps1 | iex"

binary

or download executable binaries directly in Release page.

Prerequisites

Configure a model (example with OpenRouter):

aichat set model my_model_1 --model-name openai/gpt-oss-20b:free --base-url https://openrouter.ai/api/v1 --api-key <YOUR_API_KEY>

aichat use model my_model_1

Chat

# Directly send a message
aichat how to view ubuntu release version

# If your message conflicts with a subcommand, wrap it with quotes
aichat "set swap memory to 0"

# other ways
aichat "<INPUT MESSAGE>"  
aichat -- <INPUT MESSAGE> 

# pipe
cat input.txt | aichat   
cat input.txt | aichat "explain this"

# pure mode (display for model/prompts configs and costs will be hide)
aichat --pure "Hello?"

Configurations And Commands

View Configurations

aichat list
aichat list model
aichat list prompt

Configure Prompts

aichat set prompt <PROMPT_CONFIG_NAME> --content "your prompt content"
aichat set prompt my_prompt_1 --content "use plain text, give extremely concise output"

Update Model Configuration (Partial Update)

aichat set model my_model_1 --temperature 0.3 --model-name gpt-4o

Set Model Temperature

aichat set model my_model_1 --temperature 0.3

Delete a Configuration Item

aichat delete model sample_model_gpt

Use Temporary API Key via Environment Variable

Useful for avoiding persistent API key storage or for testing. it will override API key in final request.

export OPENAI_API_KEY=sk-***************
aichat "Hello?"

Configuration Files

On first run, the config file is automatically initialized.

Configuration file locations (cross-platform):

• Linux: ~/.config/terminal-aichat/config.json
• macOS: ~/Library/Application Support/terminal-aichat/config.json
• Windows: %APPDATA%\terminal-aichat\config.json

The encryption key file is stored as aes_key.bin in the config directory (used to encrypt API keys and avoid plaintext storage).

# View config directory location
aichat list

# View config file content (Linux example)
cat ~/.config/terminal-aichat/config.json

Set Log Level

export LOG_LEVEL=DEBUG

Equivalent to using --verbose

Pure Mode (--pure)

Suppresses all extra messages and outputs only the response.

aichat --pure "Hello?"

Verbose Logging (--verbose)

aichat --verbose "Hello?"

Disable Streaming Mode (--disable-stream)

aichat --disable-stream "Hello?"