> ## Documentation Index
> Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatCLI

> The CLI that brings the power of LLMs to your terminal. Multi-provider, agent mode, coder mode, K8s watcher, and much more.

**Your terminal becomes an AI engineer.** **ChatCLI** brings the leading large language models (LLMs) straight into your shell — it understands your project's context, edits code, runs commands and automates complex tasks, without you ever leaving the command line. A single **Go** binary: fast, portable and self-contained.

<Frame caption="ChatCLI in action — interactive mode with context and agent mode">
  <img src="https://mintcdn.com/encom/jXe34OctYqDbxuDm/images/chatcli-demo.gif?s=9e1e37199807ada6c61d9fd78bda0cf8" alt="ChatCLI Demo" width="852" height="480" data-path="images/chatcli-demo.gif" />
</Frame>

<Snippet file="en/badges.mdx" />

<CardGroup cols={4}>
  <Card title="15 providers" icon="shuffle">
    OpenAI, Claude, Gemini, Grok, Ollama and more — in a single interface.
  </Card>

  <Card title="350+ models" icon="layer-group">
    One unified catalog. Switch model at any time.
  </Card>

  <Card title="37+ native tools" icon="wand-magic-sparkles">
    `@coder`, `@lsp`, `@proc`, `@http`, `@api-explorer`, `@knowledge`, `@memory` and many more.
  </Card>

  <Card title="7 quality patterns" icon="sparkles">
    ReAct · Reflexion · CoVe · RAG+HyDE · Self-Refine…
  </Card>
</CardGroup>

In practice, your everyday terminal turns into this:

```console theme={"system"}
$ chatcli

› @git  write the commit message from the staged diff
  ⮑  feat(api): add pagination to the /users endpoint

› /agent  fix the failing test in ./cli/plugins
  ⮑  plan: run tests → locate the failure → edit → re-verify ✓

› @diagram gomod root=. output=~/arch.svg
  ⮑  Diagram rendered → ~/arch.svg (SVG, 245 KB)
```

<Tip>
  The **CLI is the main product** — it works 100% locally, no server required. The server and operator are optional for team and Kubernetes scenarios. All versions are published automatically on every release via GitHub Actions. Check the full history on [Releases](https://github.com/diillson/chatcli/releases) or [ArtifactHub](https://artifacthub.io/packages/search?repo=chatcli).
</Tip>

***

## Architecture

ChatCLI ships as three artifacts that **work standalone or together**: the local CLI, the gRPC server, and the Kubernetes operator. Use just the CLI on your terminal, or set up a full topology with server + operator for teams and production environments.

<Snippet file="architecture-diagram.mdx" />

***

## Current versions

<CardGroup cols={2}>
  <Card title="ChatCLI (Client)" icon="terminal" href="/getting-started/installation">
    **1.186.1** — The binary you install and use in your terminal. Interactive mode, agent, coder, smart context, and remote server connection. <br />
    `brew install chatcli` · `go install` · [binary](https://github.com/diillson/chatcli/releases)
  </Card>

  <Card title="gRPC Server" icon="server" href="/features/server-mode">
    **1.186.1** — Centralized deployment for teams. Clients connect via `chatcli connect` and share LLM providers, sessions, and plugins. <br />
    `ghcr.io/diillson/chatcli:1.186.1`
  </Card>

  <Card title="AIOps Operator" icon="dharmachakra" href="/features/k8s-operator">
    **1.186.1** — Autonomous incident detection, AI-powered analysis, and automated remediation for Kubernetes clusters. 17 CRDs, 54+ actions. <br />
    `ghcr.io/diillson/chatcli-operator:1.186.1`
  </Card>

  <Card title="Helm Charts" icon="cube" href="/features/artifacthub">
    **1.186.1** — Distributed via ArtifactHub and OCI registry on GHCR. <br />
    `oci://ghcr.io/diillson/charts/chatcli` <br />
    `oci://ghcr.io/diillson/charts/chatcli-operator`
  </Card>
</CardGroup>

***

## Quick start

<Steps>
  <Step title="Install" icon="download">
    <Snippet file="en/install-quickstart.mdx" />
  </Step>

  <Step title="Configure a provider" icon="key">
    <Snippet file="en/configure-provider.mdx" />
  </Step>

  <Step title="Start using it!" icon="rocket">
    ```bash theme={"system"}
    chatcli
    ```

    Done — you're chatting with an LLM in your terminal, with full access to your project context.
  </Step>
</Steps>

***

## Highlights

Four pillars that define ChatCLI:

<CardGroup cols={2}>
  <Card title="Agent Mode" icon="robot" href="/core-concepts/agent-mode" horizontal>
    Delegate tasks with {'/agent'}: the AI plans, executes with your approval and self-corrects — with built-in safety against dangerous actions.
  </Card>

  <Card title="Coder Mode" icon="code" href="/core-concepts/coder-mode" horizontal>
    Software engineering with {'/coder'}: reads, edits, applies patches and runs tests in a loop with automatic rollback.
  </Card>

  <Card title="Multi-provider" icon="shuffle" href="/reference/supported-models" horizontal>
    15 providers and 350+ models — OpenAI, Claude, Gemini, Grok, Ollama… switch at any time, from a single interface.
  </Card>

  <Card title="Quality Harness" icon="sparkles" href="/features/quality/overview" horizontal>
    7 reliability patterns (ReAct, Reflexion, CoVe, RAG+HyDE, Self-Refine…) opt-in via `/config quality`.
  </Card>
</CardGroup>

And, in the same binary:

<CardGroup cols={2}>
  <Card title="Atomic Tools" icon="wand-magic-sparkles" href="/features/atomic-tools">
    {'@read'}, {'@search'}, {'@tree'} narrow read-only + {'@todo'} (TodoWrite parity) + {'@coder multipatch'} transactional. Architectural parity with Claude Code.
  </Card>

  <Card title="Smart Context" icon="eye" href="/core-concepts/context-commands">
    Inject context with {'@file'}, {'@git'}, {'@command'}, {'@env'}, and {'@history'}. Your environment straight into the AI prompt.
  </Card>

  <Card title="Multi-Agent" icon="network-wired" href="/features/multi-agent-orchestration">
    14 built-in specialist agents (File, Coder, Shell, Git, Search, Planner, Reviewer, Tester...) in parallel.
  </Card>

  <Card title="Agent Squad" icon="people-group" href="/features/agent-squad">
    Live run observability, shared kanban board, agent-to-agent mail, and an autonomous plan → develop → review → deliver playbook.
  </Card>

  <Card title="Customizable Agents" icon="user-gear" href="/features/customizable-agents">
    Create personas with reusable skills in Markdown. Version-controlled with Git, shareable across teams.
  </Card>

  <Card title="K8s Watcher and AIOps" icon="dharmachakra" href="/features/k8s-watcher">
    Monitor K8s workloads in real time. Operator with 17 CRDs, 54+ remediation actions, log analysis, and metrics.
  </Card>

  <Card title="Durable Scheduler" icon="calendar" href="/features/scheduler">
    Cron, wait-until, DAG, and daemon mode. Jobs survive CLI restarts. Agents schedule their own follow-ups.
  </Card>

  <Card title="ArtifactHub" icon="cube" href="/features/artifacthub">
    Helm charts published to ArtifactHub with automated CI/CD, 17 documented CRDs, and OCI registry.
  </Card>

  <Card title="Conversation Control" icon="clock-rotate-left" href="/features/conversation-control">
    {'/compact'} compacts history preserving what matters. {'/rewind'} and Esc+Esc go back to any point.
  </Card>

  <Card title="Hooks and Web Tools" icon="webhook" href="/features/hooks-system">
    Lifecycle hooks (pre/post tool, session start/end), native WebFetch and WebSearch to enrich context.
  </Card>
</CardGroup>

***

## Problems ChatCLI solves

<CardGroup cols={2}>
  <Card title="Endless copy and paste" icon="copy">
    No more `cat file.js`, selecting text, Ctrl+C, opening the browser, pasting, and typing your question. Use `@file` directly in the terminal.
  </Card>

  <Card title="Generic commits" icon="code-commit">
    `@git` + a question = perfect commit message based on the actual diff of your code.
  </Card>

  <Card title="Intimidating log analysis" icon="scroll">
    Pipe directly to the AI: `cat error.log | chatcli -p "root cause?"` — instant diagnosis.
  </Card>

  <Card title="Learning curve" icon="graduation-cap">
    `@file ./src --mode smart` and ask: "how does auth work?" — onboarding in minutes.
  </Card>
</CardGroup>

***

## Who is ChatCLI for?

<CardGroup cols={2}>
  <Card title="Developers" icon="laptop-code">
    Debug code, understand codebases, generate tests, refactor, and document — all without leaving the terminal.
  </Card>

  <Card title="DevOps / SREs" icon="gears">
    Analyze K8s logs, automate deploys, diagnose incidents with AI, and monitor clusters.
  </Card>

  <Card title="CLI Enthusiasts" icon="terminal">
    Supercharge your terminal, create powerful aliases, and explore new ways to interact with AI.
  </Card>

  <Card title="DBAs / Data Engineers" icon="database">
    Automate repetitive tasks, analyze queries, manage databases, and data pipelines.
  </Card>
</CardGroup>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Full installation guide" icon="download" href="/getting-started/installation">
    Homebrew, binary, go install, from source, Docker, and OAuth.
  </Card>

  <Card title="Basic usage" icon="terminal" href="/core-concepts/basic-usage">
    Essential commands, modes, and navigation in the interactive prompt.
  </Card>

  <Card title="Cookbook" icon="kitchen-set" href="/cookbook/agent-refactoring">
    Practical recipes: agent refactoring, log debugging, K8s monitoring, AIOps in production.
  </Card>

  <Card title="API Reference" icon="code" href="/reference/api/overview">
    REST endpoints for the server and operator: incidents, SLOs, runbooks, analytics, federation.
  </Card>
</CardGroup>

***

## Recent updates

<Card title="Changelog" icon="clock-rotate-left" href="/changelog">
  The full release history — every major and minor version — lives in the **Changelog**. Patches and hotfixes ship to [GitHub Releases](https://github.com/diillson/chatcli/releases), the source of truth.
</Card>