Command Line Artificial Intelligence

Test coverage: 81.740% 😍👌

---

Get started

Installing:

curl -fsSL https://raw.githubusercontent.com/baalimago/clai/main/setup.sh | sh

You can also install via go:

go install github.com/baalimago/clai@latest

Then run:

clai | clai query Please give a concise explanation of clai

Either run bare clai (or clai <command> -h) or look at the examples for how to use clai. Prompt text starting with - is read as a flag, so pass it after --: clai q -- -why does this fail. If you have time, you can also check out this blogpost for a slightly more structured introduction on how to use Clai efficiently.

Install Glow for formatted markdown output when querying text responses.

Use clai as a Go library

Embed the agent loop in a Go program with github.com/baalimago/clai/pkg/agent:

// Supports strucutred output via types
// Support all things the CLI does
review, err := agent.NewTyped[Review](agent.WithModel("gpt-5.2")).Query(ctx, chat)

The agent runs silent and returns typed errors. See pkg/agent for the option surface, the command ban list and the token stoploss, and pkg/tools for the tool catalog.

Features

• Shell context injection - Inject shell context into the system prompt via configurable templates.
• Seamless conversation import - Ran out of session? Continue in clai!
• Agent Skills - Import skills from custom global directories, or project-level .agents/skills.
• Profiles - Pre-prompted profiles enabling customized workflows and agents.
• MCP client support - Add any MCP server you'd like by pasting their configuration.
• Unix-like - Clai follows the unix philosophy and works with data piped in and out.

All of these features are easily combined and tweaked, empowering users to accomplish very diverse use cases. See examples for additional info.

Supported vendors

---

Shell completions are also available:

# bash
mkdir -p ~/.local/share/bash-completion/completions
clai completion bash > ~/.local/share/bash-completion/completions/clai

# zsh
mkdir -p ~/.zsh/completions
clai completion zsh > ~/.zsh/completions/_clai

For zsh, ensure your fpath includes the completions directory before compinit, for example:

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit && compinit

Then restart your shell or reload your shell configuration.