# clai

> Command-line AI toolkit for people and agents, with cloud config backup, community hub, and multi-vendor transcript sync on clai.chat.

## Start
- [Introduction](https://www.clai.chat/docs.md): What clai is, its CLI commands, supported LLM vendors, and the clai.chat cloud roadmap.
- [Quickstart](https://www.clai.chat/docs/quickstart.md): Install clai, configure your first model vendor, run terminal queries, and manage chats.
- [Installation](https://www.clai.chat/docs/installation.md): Install clai with Go, Nix, or from source, and verify your config directory.

## Guides
- [Queries and unix pipes](https://www.clai.chat/docs/guides/queries-and-pipes.md): Compose clai with standard input, placeholder substitution, raw output, and cron scripts.
- [Chats and multi-vendor import](https://www.clai.chat/docs/guides/chats-and-vendors.md): Continue multi-turn conversations and import transcripts from Claude Code, Codex, OpenCode, Gemini CLI, Qwen, and Antigravity.
- [Profiles and setup](https://www.clai.chat/docs/guides/profiles.md): Create reusable profiles with custom system prompts, models, MCP servers, and tool allowlists using clai setup.
- [MCP servers and builtin tools](https://www.clai.chat/docs/guides/mcp-and-tools.md): Enable builtin terminal tools and connect external Model Context Protocol (MCP) servers to clai.
- [Agent Skills and shell context](https://www.clai.chat/docs/guides/skills-and-shell-context.md): Use portable SKILL.md Agent Skills and inject live shell/git context into clai prompts.
- [Photo and video generation](https://www.clai.chat/docs/guides/photo-and-video.md): Generate images and videos from the command line with clai photo and clai video.
- [Share and rate configs](https://www.clai.chat/docs/guides/community-hub.md): Publish a whole agent (one clai profile), or an MCP server, shell context, Agent Skill, theme or prompt, to the public hub, and rate and discuss the ones you use.

## Concepts
- [Architecture overview](https://www.clai.chat/docs/concepts/architecture.md): How clai parses flags, constructs vendor queriers, executes the agent tool loop, and streams responses.
- [Context management and cost saving](https://www.clai.chat/docs/concepts/context-and-cost.md): How clai bounds a run: a token stop-loss with a handover, tool-call budgets, tool filtering by glob, and lookback that reads only what it needs.
- [Multi-vendor transcripts](https://www.clai.chat/docs/concepts/multi-vendor-transcripts.md): How clai normalizes messages and tool calls across LLM vendors and external coding harnesses.

## Reference
- [CLI](https://www.clai.chat/docs/reference/cli.md): Complete command and flag reference for the clai binary.
- [Builtin and MCP tools](https://www.clai.chat/docs/reference/tools.md): Reference for clai builtin tools and Model Context Protocol (MCP) server integration.
- [Configuration](https://www.clai.chat/docs/reference/configuration.md): Where clai keeps its configuration files, what each file holds, and the environment variables it reads.
- [Supported vendors](https://www.clai.chat/docs/reference/vendors.md): The vendors clai speaks to, the API key each one reads, and the model files they share.
- [Errors and troubleshooting](https://www.clai.chat/docs/reference/errors.md): The error vocabulary clai returns, what each meaning points at, and the switches that show more.
- [Go packages (pkg/agent and pkg/tools)](https://www.clai.chat/docs/reference/go-sdk.md): Embed clai agents and tools directly in your own Go applications via pkg/agent and pkg/tools.

## Optional
- [Versioning policy](https://www.clai.chat/docs/project/versioning.md): How clai releases, configuration schemas, and documentation versions are maintained.
- [Changelog](https://www.clai.chat/docs/project/changelog.md): Notable releases and new features in clai and clai.chat.