tai — Terminal AI

Generate shell commands from natural language, right in your terminal.

tai uses your GitHub Copilot SDK to suggest commands. Select one, run it, or edit it before executing.

Prerequisites

• GitHub Copilot CLI — installed and logged in (subscription required)

Installation

curl -fsSL https://raw.githubusercontent.com/NitorCreations/tai/main/install.sh | sh

The binary is placed at ~/.local/share/tai/tai.

Add to PATH

Add the install directory to your PATH so you can run tai directly:

export PATH="$HOME/.local/share/tai:$PATH"

Add this to ~/.bashrc or ~/.zshrc to make it permanent.

Shell keybinding widget (optional)

tai widget prints a shell snippet that defines _tai_widget and binds it to Ctrl+T. The widget lets tai place a command directly into your prompt line (editable before running) instead of executing it immediately.

# Load into current shell (one-time)
eval "$(tai widget)"          # auto-detects bash or zsh
eval "$(tai widget bash)"     # explicit
eval "$(tai widget zsh)"      # explicit

# Override the default Ctrl+T binding
eval "$(tai widget bash --key '\C-g')"
eval "$(tai widget zsh  --key '^G')"

To persist across sessions, add the eval line to ~/.bashrc or ~/.zshrc.

Tab completions (optional)

To load in the current shell:

eval "$(tai completion bash)"    # or: tai completion zsh

To persist across sessions, add the same line to ~/.bashrc or ~/.zshrc.

Usage

tai ask                       # open interactive prompt
tai ask "list open ports"     # start with a query pre-filled

TUI key bindings

State	Key	Action
Input	Enter	Submit query
Results	↑ / ↓	Navigate suggestions
Results	Enter	Accept and run command
Results	Tab	Edit command before running
Results	/	Follow-up query (refine results)
Editing	Enter	Run edited command
Editing	Esc	Cancel edit, back to results
Follow-up	Enter	Submit follow-up
Follow-up	Esc / Ctrl+C	Back to results
Any	Ctrl+C	Quit

Commands marked with ⚠ are flagged as potentially destructive.

Configuration

Config file: ~/.config/tai/config.json

tai config get model           # print current model
tai config set model gpt-4o    # change model
tai config edit                # open in $EDITOR
tai config reset               # restore defaults

Default model is auto (Copilot selects the model).

Building from source

git clone https://github.com/NitorCreations/tai.git
cd tai
make

The binary is placed in dist/.

License

MIT — see LICENSE.