Skip to main content
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.
ChatCLI Demo

ChatCLI in action โ€” interactive mode with context and agent mode

15 providers

OpenAI, Claude, Gemini, Grok, Ollama and more โ€” in a single interface.

350+ models

One unified catalog. Switch model at any time.

37+ native tools

@coder, @lsp, @proc, @http, @api-explorer, @knowledge, @memory and many more.

7 quality patterns

ReAct ยท Reflexion ยท CoVe ยท RAG+HyDE ยท Self-Refineโ€ฆ
In practice, your everyday terminal turns into this:
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 or ArtifactHub.

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.

Current versions

ChatCLI (Client)

1.172.0 โ€” The binary you install and use in your terminal. Interactive mode, agent, coder, smart context, and remote server connection.
brew install chatcli ยท go install ยท binary

gRPC Server

1.172.0 โ€” Centralized deployment for teams. Clients connect via chatcli connect and share LLM providers, sessions, and plugins.
ghcr.io/diillson/chatcli:1.172.0

AIOps Operator

1.172.0 โ€” Autonomous incident detection, AI-powered analysis, and automated remediation for Kubernetes clusters. 17 CRDs, 54+ actions.
ghcr.io/diillson/chatcli-operator:1.172.0

Helm Charts

1.172.0 โ€” Distributed via ArtifactHub and OCI registry on GHCR.
oci://ghcr.io/diillson/charts/chatcli
oci://ghcr.io/diillson/charts/chatcli-operator

Quick start

Install

Configure a provider

Start using it!

Done โ€” youโ€™re chatting with an LLM in your terminal, with full access to your project context.

Highlights

Four pillars that define ChatCLI:

Agent Mode

Delegate tasks with : the AI plans, executes with your approval and self-corrects โ€” with built-in safety against dangerous actions.

Coder Mode

Software engineering with : reads, edits, applies patches and runs tests in a loop with automatic rollback.

Multi-provider

15 providers and 350+ models โ€” OpenAI, Claude, Gemini, Grok, Ollamaโ€ฆ switch at any time, from a single interface.

Quality Harness

7 reliability patterns (ReAct, Reflexion, CoVe, RAG+HyDE, Self-Refineโ€ฆ) opt-in via /config quality.
And, in the same binary:

Atomic Tools

, , narrow read-only + (TodoWrite parity) + transactional. Architectural parity with Claude Code.

Smart Context

Inject context with , , , , and . Your environment straight into the AI prompt.

Multi-Agent

14 built-in specialist agents (File, Coder, Shell, Git, Search, Planner, Reviewer, Testerโ€ฆ) in parallel.

Customizable Agents

Create personas with reusable skills in Markdown. Version-controlled with Git, shareable across teams.

K8s Watcher and AIOps

Monitor K8s workloads in real time. Operator with 17 CRDs, 54+ remediation actions, log analysis, and metrics.

Durable Scheduler

Cron, wait-until, DAG, and daemon mode. Jobs survive CLI restarts. Agents schedule their own follow-ups.

ArtifactHub

Helm charts published to ArtifactHub with automated CI/CD, 17 documented CRDs, and OCI registry.

Conversation Control

compacts history preserving what matters. and Esc+Esc go back to any point.

Hooks and Web Tools

Lifecycle hooks (pre/post tool, session start/end), native WebFetch and WebSearch to enrich context.

Problems ChatCLI solves

Endless copy and paste

No more cat file.js, selecting text, Ctrl+C, opening the browser, pasting, and typing your question. Use @file directly in the terminal.

Generic commits

@git + a question = perfect commit message based on the actual diff of your code.

Intimidating log analysis

Pipe directly to the AI: cat error.log | chatcli -p "root cause?" โ€” instant diagnosis.

Learning curve

@file ./src --mode smart and ask: โ€œhow does auth work?โ€ โ€” onboarding in minutes.

Who is ChatCLI for?

Developers

Debug code, understand codebases, generate tests, refactor, and document โ€” all without leaving the terminal.

DevOps / SREs

Analyze K8s logs, automate deploys, diagnose incidents with AI, and monitor clusters.

CLI Enthusiasts

Supercharge your terminal, create powerful aliases, and explore new ways to interact with AI.

DBAs / Data Engineers

Automate repetitive tasks, analyze queries, manage databases, and data pipelines.

Next steps

Full installation guide

Homebrew, binary, go install, from source, Docker, and OAuth.

Basic usage

Essential commands, modes, and navigation in the interactive prompt.

Cookbook

Practical recipes: agent refactoring, log debugging, K8s monitoring, AIOps in production.

API Reference

REST endpoints for the server and operator: incidents, SLOs, runbooks, analytics, federation.

Recent updates

We only highlight major and minor versions here. Patches and hotfixes ship to GitHub Releases โ€” the source of truth for the full changelog.
2026-07-28
  • update โ€” announce new releases in-session and revamp version UX
2026-07-27
  • providers โ€” list all gateway models when endpoint URL is customized
2026-07-24
  • models โ€” add Claude Opus 5 to the Anthropic, Bedrock and OpenRouter catalogs
  • update โ€” channel-aware auto-update with /update command and staged background mode
2026-07-21
  • bedrock โ€” BEDROCK_MODEL selects the default model
2026-07-21
  • bedrock โ€” custom endpoint overrides for corporate DNS and VPC
2026-07-20
  • session โ€” proactive cross-session recall with tolerant search and titles
2026-07-19
  • park โ€” capture user messages typed while parked as resume directives
2026-07-17
  • session โ€” MCP session autosave by default and bounded machine-session lifecycle
2026-07-17
  • memory โ€” derive rollups from the episodic record
  • memory โ€” episodic timeline with temporal recall
  • memory โ€” proactive auto-recall in index mode
  • session โ€” sessions become retrievable memory
  • devin โ€” drop identity coercion and accept tool tag alias
2026-07-16
  • mcp-server โ€” full ChatCLI experience parity over MCP
2026-07-14
  • agent โ€” @model tool โ€” AI-driven model/provider routing with tiered catalog and delegate
2026-07-13
  • mcp โ€” re-export connected MCP serversโ€™ tools on the mcp-server surface
2026-07-12
  • ui โ€” add ui/kit presentation components and fix help header styling
  • ui โ€” adopt the sรณbrio borderless treatment across chat, agent and coder
  • ui โ€” align command surfaces on kit padding, rules and notices
  • ui โ€” make the welcome screen responsive and theme-aware
  • ui โ€” sweep agent timeline glyphs and rules onto the kit vocabulary
  • cli โ€” restore spinner, type-ahead queue and AltGr input in the Windows chat REPL
  • i18n โ€” honor CHATCLI_LANG from .env and detect the Windows locale
  • i18n โ€” sentence-case display titles and notice-based session status
  • i18n โ€” strip variation selectors and embedded rules from the catalogs
  • ui โ€” give warnings their own theme role
2026-07-11
  • mcp โ€” OAuth 2.1 authorization for remote MCP servers
2026-07-10
  • DEVIN provider โ€” local Devin CLI as LLM transport
  • full MCP + ACP server surface โ€” every tool, harness routing, skills as prompts
  • embedding โ€” circuit-break Bedrock credential failures instead of hammering AWS
2026-07-10
  • GPT-5.6 family (Sol/Terra/Luna) + Codex client headers fix
2026-07-10
  • mcp โ€” dynamic tool discovery on tools/list_changed notifications
2026-07-09
  • agent โ€” adaptive payload-cap recovery, bounded prompt floor and zero-loss compaction (48f3c0c)
  • plugins โ€” tolerate the CCR key syntax variants models actually produce (8ebe661)
2026-07-08
  • add @api-explorer builtin for end-to-end API reconnaissance (cc99eab)
2026-07-07
  • skills โ€” match multi-word triggers in any word order
  • skills โ€” re-activate skills mid-loop in agent and coder modes
2026-07-03
  • tools โ€” expose MCP tools through the @tools catalog
2026-07-02
  • agent โ€” defer the tool catalog โ€” index plus on-demand @tools describe
  • compress โ€” harden CCR reversibility and add runtime profiles
  • http โ€” structured HTTP client for the agent as the @http tool
  • lsp โ€” expose semantic code navigation to the agent as the @lsp tool
  • proc โ€” background-process supervision for the agent as the @proc tool
  • ctxmgr โ€” harden knowledge-mode durability, UTF-8 boundaries and retrieval cost
  • lint โ€” zero both module baselines and enforce full-module linting
  • memory โ€” eliminate silent memory-loss vectors and harden retrieval
2026-07-01
  • models โ€” Claude Sonnet 5 + GLM-5.2 + Bedrock Fable 5/Sonnet 5 support
2026-06-28
  • graphview โ€” interactive grap-style, graph in agent, coder and chat
2026-06-26
  • live telemetry in agent/coder + on-demand CCR curation
2026-06-25
  • self-evolution engine, in-core knowledge graph and memory quality
2026-06-22
  • native context compression, image compression and output-token reduction
2026-06-21
  • plugins โ€” add @diagram builtin for embedded Graphviz rendering
  • plugins โ€” add selectable system/embedded Graphviz backend to @diagram (3ea68b5)
2026-06-18
  • multimodal vision input + multi-provider image editing
2026-06-17
  • docs-flatten โ€” ingest code and infra repos into knowledge bases
  • coder โ€” recover stdin after Ctrl+C at a security confirmation
2026-06-15
  • full @context parity + @registry-tags sort/last
2026-06-14
  • context โ€” autonomous knowledge-base management via @context
  • plugins โ€” add @registry-tags and @wikipedia builtins
2026-06-13
  • transcription โ€” pure-Go OGG/Opus decoding and actionable ffmpeg guidance
2026-06-12
  • plugins โ€” bring @docs-flatten in as a builtin tool
2026-06-11
  • tls โ€” global corporate TLS trust overrides for all outbound clients
2026-06-10
  • context โ€” knowledge mode: index-card attach + keyless hybrid retrieval (BM25 + embeddings) + @knowledge pull tool (agent/coder/chat)
  • i18n โ€” stop x/text from stamping MISSING into argless lookups
2026-06-10
  • transcription โ€” embedded offline Whisper STT via sherpa-onnx
2026-06-09
  • webfetch โ€” render JS pages via headless browser escalation
  • websearch โ€” keyless fallback providers + Claude Fable 5 in catalog
  • embedding โ€” rebuild embedding provider on /reload
  • operator โ€” resolve all 82 open gosec findings
2026-06-09
  • context โ€” semantic passage retrieval for /context attach
  • memory โ€” blend cosine, lexical and temporal signals in retrieval ranking
2026-06-06
  • gateway โ€” voice replies, embedded TTS and memory resilience
2026-06-06
  • imagegen โ€” Z.AI + MiniMax image backends, model-aware auto, and /model-image
2026-06-04
  • proactive messaging, productivity skills pack, and multimodal agent tools
2026-06-03
  • gateway โ€” voice messages (transcription) + conversational replies
2026-06-01
  • add interactive ask_user tool for agent, coder and chat
2026-05-31
  • cli โ€” interactive command palette overlay
2026-05-30
  • cli โ€” gateway runtime model, /model + /max-tokens, 9 new themes
  • gateway โ€” list stop in the /gateway usage hint
2026-05-29
  • ui โ€” unified color theme system + indentation-safe rendering
2026-05-29
  • catalog โ€” add Claude Opus 4.8 with adaptive thinking and fast mode
2026-05-27
  • gateway โ€” messaging gateway โ€” Telegram, Slack, Discord, WhatsApp, Webhook
  • hub โ€” cross-channel conversation continuity via shared hub
  • lsp โ€” language server diagnostics via /lsp
  • memory hybrid capture, security & multi-provider robustness (Tiers A+B+partial C)
  • rpcserve โ€” MCP server + ACP agent over stdio
2026-05-23
  • aiops โ€” close 5 gaps surfaced by 2026-05-23 chaos test
2026-05-23
  • auth โ€” TokenProvider with proactive OAuth refresh and retry-on-401
2026-05-21
  • mcp โ€” complete channel push delivery, reactive triggers and persistence
2026-05-20
  • ui โ€” cross-mode UI polish โ€” i18n, red errors, lipgloss cards, unified banners
2026-05-17
  • Claude Code parity tool layer (atomic tools, @todo, multipatch, schema validation, per-tool policies)
  • tool layer enterprise refactor (security UX + parallel orchestration + provider-agnostic tool_result)
2026-05-15
  • mcp โ€” add Streamable HTTP transport (MCP 2025-03-26)
2026-05-15
  • moonshot โ€” add Moonshot (Kimi) provider with thinking-mode support
  • qg โ€” 15-floor Quality Gate overhaul โ€” fix Floor 3, add 6 floors, redesign table
2026-05-12
  • mcp โ€” tier 1-3 server config extensions + autoApprove audit
2026-05-11
  • skills โ€” session-scoped pin for multi-turn auto-injection
2026-05-08
  • mcp โ€” per-server commands + logs ring + manual reload
  • coder โ€” use go-prompt for iteration input (paste + full width)
  • mcp โ€” inherit parent env, expand $, and hot-reload from empty state
2026-05-05
  • Agent Park & Resume โ€” @park tool that suspends the agent loop, frees the terminal, and auto-resumes itself when the timer/probe completes. Four modes: delay, until, for_url, for_cmd โ€” plus /park-note and @park list/note to send directives to a parked agent, delivered at resume. See Agent Park & Resume.
  • Foreground auto-resume โ€” TIOCSTI on Unix and WriteConsoleInputW on Windows automatically inject /resume <token> into the TTY; transparent fallback when the kernel restricts it (Linux 6.x+, macOS Ventura+).
  • Management slash commands โ€” /parked (list), /resume <token>, /cancel-park <token> with prefix-match and idempotency against the auto-resume race.
  • Operator SchemeBuilder migration โ€” controller-runtime 0.24 deprecated sigs.k8s.io/controller-runtime/pkg/scheme.Builder; migrated to apimachineryโ€™s runtime.NewSchemeBuilder (โ€“43 net lines).
2026-04-30
  • Scheduler (Chronos) โ€” cron, wait-until, DAG, and daemon mode with durable WAL
  • Bedrock provider โ€” Claude/Llama/Nova via AWS Bedrock with IAM/profile/credentials chain
  • Token waste audit โ€” cache in agent mode, cached tool defs, early-exit/routing
  • Anthropic cache coalescer โ€” local planner respecting the 4-marker cap without losing cache
  • /config sections โ€” became hierarchical (/config <section>) with runtime mutation
2026-04-15
  • MCP client + hooks + web tools โ€” parity with Claude Code
  • Cost tracking with per-provider price tables
  • Plan mode + worktrees integrated
2026-03-29
  • Harness/Quality Pipeline (7 patterns) โ€” ReAct + Plan-and-Solve + Reflexion + RAG+HyDE + Self-Refine + CoVe + Reasoning Backbone
  • Context injection via system prompt with Anthropic caching
  • Bubble Tea TUI as default (go-prompt removed)
Track all releases on GitHub Releases or ArtifactHub.