Instalação e Configuração

Pré-requisitos

Git

Necessário para clonar o repositório e para que o Go baixe dependências.

Go 1.26+

Apenas para go install ou compilação do código-fonte.

API Key ou OAuth

Chave de API de um provedor LLM ou conta com plano ativo para OAuth.

1. Instalação

Homebrew (Recomendado)
Binário
go install
Código-Fonte
Docker

A maneira mais fácil para macOS e Linux. Instala e atualiza automaticamente.

brew tap diillson/chatcli
brew install chatcli

Para atualizar:

brew upgrade chatcli

Suporta macOS (Apple Silicon e Intel) e Linux (amd64). A fórmula é atualizada automaticamente a cada release.

Baixe o binário para seu sistema diretamente da página de Releases.

# Linux/macOS — ajuste o nome do arquivo conforme o release
chmod +x chatcli
sudo mv chatcli /usr/local/bin/

Disponível para Linux, macOS e Windows em arquiteturas amd64 e arm64.

Se você tem o Go instalado:

go install github.com/diillson/chatcli@latest

O binário será instalado em $GOPATH/bin. Garanta que está no PATH:

export PATH=$PATH:$(go env GOPATH)/bin

Adicione a linha acima ao seu .bashrc ou .zshrc para persistir entre sessões.

Para quem quer compilar localmente ou contribuir:

Clone o repositório

git clone https://github.com/diillson/chatcli.git
cd chatcli

Compile

go mod tidy
go build -o chatcli

(Opcional) Build com informações de versão

VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev")
COMMIT_HASH=$(git rev-parse --short HEAD)
BUILD_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

go build -ldflags "\
  -X github.com/diillson/chatcli/version.Version=${VERSION} \
  -X github.com/diillson/chatcli/version.CommitHash=${COMMIT_HASH} \
  -X github.com/diillson/chatcli/version.BuildDate=${BUILD_DATE}" \
  -o chatcli main.go

Isso injeta dados de versão no binário, acessíveis via /version ou chatcli --version.

Mova para o PATH

sudo mv chatcli /usr/local/bin/

2. Configurar um Provedor

Crie um arquivo .env na sua pasta de usuário ou na raiz do projeto.

LLM_PROVIDER=OPENAI
OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo específico — padrão: gpt-5.4
# OPENAI_MODEL="gpt-5.4"

LLM_PROVIDER=CLAUDEAI
ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo — padrão: claude-sonnet-4-6
# ANTHROPIC_MODEL="claude-sonnet-4-6"

LLM_PROVIDER=GOOGLEAI
GOOGLEAI_API_KEY="AIzaxxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo — padrão: gemini-2.5-flash
# GOOGLEAI_MODEL="gemini-2.5-flash"

LLM_PROVIDER=XAI
XAI_API_KEY="xai-xxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo — padrão: grok-4-1
# XAI_MODEL="grok-4-1"

LLM_PROVIDER=BEDROCK

# Credenciais vêm da cadeia do AWS SDK — escolha UMA fonte:
AWS_PROFILE="meu-profile"
# AWS_ACCESS_KEY_ID="AKIAxxxxxxxxxxxxxxxx"
# AWS_SECRET_ACCESS_KEY="xxxxxxxxxxxxxxxxxxxxxxxx"

# Região do Bedrock (fallback: AWS_REGION)
BEDROCK_REGION="us-east-1"

# (Opcional) Modelo padrão — aliases do catálogo funcionam
# BEDROCK_MODEL="claude-opus-4-8"

O Bedrock não usa API key — a autenticação é a cadeia de credenciais do AWS SDK: env vars → profiles do ~/.aws (SSO, assume-role) → IAM role (EC2/ECS/EKS). Para SSO, VPC endpoints, overrides de schema e inference profiles, veja AWS Bedrock.

LLM_PROVIDER=STACKSPOT
CLIENT_ID="seu-client-id"
CLIENT_KEY="seu-client-secret"

# (Opcional) Realm/tenant — padrão: zup
# STACKSPOT_REALM="seu-tenant-name"

# (Opcional) Agent ID — padrão: default
# STACKSPOT_AGENT_ID="seu-agent-id"

A autenticação é feita via OAuth 2.0 Client Credentials. Obtenha suas credenciais no portal da StackSpot. Você também pode sobrescrever realm e agent-id via flags na linha de comando:

chatcli --provider STACKSPOT --realm "meu-realm" --agent-id "meu-agent" -p "Sua pergunta"

LLM_PROVIDER=ZAI
ZAI_API_KEY="xxx"

# (Opcional) Modelo — padrão: glm-5
# ZAI_MODEL="glm-5"

LLM_PROVIDER=MINIMAX
MINIMAX_API_KEY="xxx"

# (Opcional) Modelo — padrão: MiniMax-M2.7 (case-sensitive!)
# MINIMAX_MODEL="MiniMax-M2.7"

LLM_PROVIDER=MOONSHOT
MOONSHOT_API_KEY="sk-xxx"

# (Opcional) Modelo — padrão: kimi-k2.6
# MOONSHOT_MODEL="kimi-k2.6"
# MOONSHOT_THINKING="auto"   # auto | enabled | disabled

LLM_PROVIDER=OPENROUTER
OPENROUTER_API_KEY="sk-or-xxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo — padrão: openai/gpt-4o
# MODEL="anthropic/claude-sonnet-4"

# (Opcional) Fallback nativo do OpenRouter
# OPENROUTER_FALLBACK_MODELS="openai/gpt-4o,google/gemini-2.5-flash"

O OpenRouter é um gateway multi-provedor que dá acesso a 200+ modelos (OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, etc.) com uma única API key. Os modelos usam o formato provedor/nome-do-modelo. Obtenha sua chave em openrouter.ai.

LLM_PROVIDER=COPILOT
GITHUB_COPILOT_TOKEN="ghu_xxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Modelo — ex.: gpt-4o, claude-sonnet-4, gemini-2.0-flash
# COPILOT_MODEL="gpt-4o"

Prefere OAuth? Dispense o token e rode /auth login github-copilot (Device Flow) — veja a aba OAuth.

LLM_PROVIDER=GITHUB_MODELS
GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxxxxxx"

# (Opcional) Token dedicado em vez do GITHUB_TOKEN
# GITHUB_MODELS_TOKEN="github_pat_xxxxxxxxxxxx"

# (Opcional) Modelo — padrão: gpt-4o
# GITHUB_MODELS_MODEL="gpt-4o"

Funciona com um Personal Access Token comum do GitHub — sem cadastro extra. Veja GitHub Models para o catálogo de modelos e rate limits.

LLM_PROVIDER=DEVIN

# (Opcional) Modelo — padrão: claude-sonnet-4.6 (slugs usam pontos)
# DEVIN_MODEL="claude-sonnet-4.6"

# (Opcional) Caminho explícito do binário — padrão: devin do PATH
# DEVIN_CLI_PATH="/usr/local/bin/devin"

Sem API key no ChatCLI — a autenticação pertence ao próprio Devin CLI (devin auth login). O ChatCLI usa o binário local devin apenas como transporte de modelo; veja Devin Provider.

Se possui ChatGPT Plus/Codex, Claude Pro ou GitHub Copilot:

chatcli

# Dentro do modo interativo:
/auth login openai-codex     # OpenAI (PKCE OAuth)
/auth login anthropic        # Anthropic (PKCE OAuth)
/auth login github-copilot   # GitHub Copilot (Device Flow)

O navegador abrirá automaticamente. Consulte a documentação de OAuth para detalhes.

LLM_PROVIDER=OLLAMA
OLLAMA_ENABLED=true
OLLAMA_BASE_URL="http://localhost:11434"
OLLAMA_MODEL="llama3"

Nenhuma API key necessária. Instale o Ollama em ollama.com e baixe um modelo com ollama pull llama3.

Você só precisa configurar os provedores que pretende usar. O ChatCLI detecta automaticamente quais estão disponíveis pelas chaves encontradas.

Variáveis de Ambiente Adicionais

Variável	Descrição	Padrão
`CHATCLI_DOTENV`	Caminho customizado para o arquivo `.env`	`.env`
`CHATCLI_LANG`	Força um idioma específico (ex: `pt-BR`, `en`)	Auto-detectado
`LOG_LEVEL`	Nível de log: `debug`, `info`, `warn`, `error`	`info`
`CHATCLI_ENV`	Modo de logging: `dev` (console colorido + arquivo), `prod` (só arquivo JSON)	`prod`
`MAX_RETRIES`	Tentativas máximas para chamadas de API	`5`

Para a lista completa de variáveis, consulte a Referência de Variáveis de Ambiente.

3. Verificar a Instalação

Verifique a versão

chatcli --version

Verifique a configuração ativa

chatcli
# Dentro do modo interativo:
/config

Faça sua primeira pergunta

O que é a equação de Dirac?

Se você receber uma resposta da IA, parabéns! O ChatCLI está pronto.

Atualizando o ChatCLI

Depois de instalado, o ChatCLI se mantém atualizado sozinho. Rode /update a qualquer momento — ele detecta como o binário foi instalado e atualiza pelo mesmo canal:

/update          # aplica a última release pelo seu canal de instalação
/update check    # só verifica

Instalações via Homebrew rodam brew upgrade diillson/chatcli/chatcli.
Instalações via go install rodam go install github.com/diillson/chatcli@latest.
Binários da release são substituídos no lugar, verificados contra o checksums.txt da release.
Docker e builds locais nunca são tocados — você recebe as instruções exatas.

Defina CHATCLI_AUTO_UPDATE=auto para aplicar em staging silencioso em background: o próximo start abre na versão nova. O default (notify) mostra o aviso na tela de boas-vindas — e na própria sessão quando uma release sai depois do boot. Veja Auto-Update para o quadro completo.

Próximos Passos

Uso Básico

Comandos essenciais, modos e navegação no prompt interativo.

Modo Agente

Delegue tarefas para a IA executar no seu terminal.

Modo Coder

IA que lê, edita e testa código em loop.

Skill Registry

Busque e instale skills de registries remotos.

Início

Primeiros Passos

Conceitos Fundamentais

Funcionalidades

Segurança

Suporte

Instalação e Configuração

Pré-requisitos

Git

Go 1.26+

API Key ou OAuth

1. Instalação

2. Configurar um Provedor

Variáveis de Ambiente Adicionais

3. Verificar a Instalação

Atualizando o ChatCLI

Próximos Passos

Uso Básico

Modo Agente

Modo Coder

Skill Registry

​Pré-requisitos

Git

Go 1.26+

API Key ou OAuth

​1. Instalação

​2. Configurar um Provedor

​Variáveis de Ambiente Adicionais

​3. Verificar a Instalação

​Atualizando o ChatCLI

​Próximos Passos

Uso Básico

Modo Agente

Modo Coder

Skill Registry

Pré-requisitos

1. Instalação

2. Configurar um Provedor

Variáveis de Ambiente Adicionais

3. Verificar a Instalação

Atualizando o ChatCLI

Próximos Passos