Receita: Servidor Remoto para Equipe

Nesta receita, você vai configurar um servidor ChatCLI centralizado que atende toda a equipe de desenvolvimento. Cada membro pode conectar do seu terminal e usar a IA sem precisar gerenciar API keys individuais.

Cenário

Equipe Pequena

5-10 desenvolvedores compartilhando recursos

API Keys Corporativas

Servidor central com chaves gerenciadas

Acesso via Terminal

Cada dev conecta do seu terminal local

Autenticação Flexível

Token compartilhado ou credenciais próprias

Configurar o Servidor

Docker Compose (Simples)
Binário Direto
Kubernetes (Helm)

Crie um arquivo .env no servidor:

# .env
CHATCLI_SERVER_TOKEN=equipe-token-2024
LLM_PROVIDER=CLAUDEAI
ANTHROPIC_API_KEY=sk-ant-xxx-chave-corporativa
ANTHROPIC_MODEL=claude-sonnet-4-5
LOG_LEVEL=info

Inicie com Docker Compose:

docker compose up -d

export CHATCLI_SERVER_TOKEN=equipe-token-2024
export LLM_PROVIDER=CLAUDEAI
export ANTHROPIC_API_KEY=sk-ant-xxx
chatcli server --port 50051

helm install chatcli deploy/helm/chatcli \
  --namespace tools --create-namespace \
  --set llm.provider=CLAUDEAI \
  --set secrets.anthropicApiKey=sk-ant-xxx \
  --set server.token=equipe-token-2024 \
  --set service.type=LoadBalancer

Distribuir Acesso

Compartilhe com a equipe:

# Adicione ao .bashrc ou .zshrc de cada dev
export CHATCLI_REMOTE_ADDR=servidor-ia:50051
export CHATCLI_REMOTE_TOKEN=equipe-token-2024

# Alias para acesso rapido
alias cia='chatcli connect'

Cada Dev Conecta

# Modo interativo
chatcli connect

# One-shot rapido
chatcli connect -p "Explique o padrão Repository em Go"

Permitir Credenciais Próprias (Opcional)

Devs que preferem usar suas próprias credenciais podem faze-lo:

# Dev que tem assinatura Claude Pro
chatcli connect --use-local-auth

# Dev que prefere OpenAI
chatcli connect --provider OPENAI --llm-key sk-minha-chave-pessoal

# Dev que usa GitHub Copilot
chatcli connect --use-local-auth --provider COPILOT

O servidor aceita ambos os modos simultaneamente. Devs podem usar as credenciais do servidor (padrão) ou fornecer suas próprias.

Adicionar TLS (Produção)

Para ambientes de produção, adicione TLS:

# Gerar certificados (ex: com Let's Encrypt ou certbot)
# Ou usar mkcert para desenvolvimento

# Iniciar com TLS
chatcli server \
  --tls-cert /etc/chatcli/cert.pem \
  --tls-key /etc/chatcli/key.pem \
  --token equipe-token-2024

Devs conectam com:

chatcli connect servidor:50051 --tls --token equipe-token-2024

Múltiplos Provedores

Configure o servidor com múltiplas API keys. Devs podem escolher o provedor:

# Servidor com OpenAI, Claude, Google AI e Copilot
export OPENAI_API_KEY=sk-xxx
export ANTHROPIC_API_KEY=sk-ant-xxx
export GOOGLEAI_API_KEY=AIzaSy-xxx
export GITHUB_COPILOT_TOKEN=ghu_xxx  # ou use /auth login github-copilot
export LLM_PROVIDER=CLAUDEAI  # padrão
chatcli server

# Dev escolhe o provedor
chatcli connect --provider OPENAI
chatcli connect --provider GOOGLEAI
chatcli connect --provider COPILOT --use-local-auth
chatcli connect  # usa o padrão (CLAUDEAI)

Compartilhar Agents, Skills e Plugins (Opcional)

Provisione agents, skills e plugins no servidor para que toda a equipe tenha acesso aos mesmos recursos:

Via Helm
Via ConfigMaps
Via Skill Registry

helm install chatcli deploy/helm/chatcli \
  --namespace tools --create-namespace \
  --set llm.provider=CLAUDEAI \
  --set secrets.anthropicApiKey=sk-ant-xxx \
  --set server.token=equipe-token-2024 \
  --set agents.enabled=true \
  --set-file agents.definitions.devops-senior\\.md=agents/devops-senior.md \
  --set skills.enabled=true \
  --set-file skills.definitions.k8s-best-practices\\.md=skills/k8s-best-practices.md \
  --set plugins.enabled=true \
  --set plugins.initImage=myregistry/chatcli-plugins:latest

# Criar ConfigMap com agents
kubectl create configmap chatcli-agents \
  --from-file=devops-senior.md=agents/devops-senior.md \
  --from-file=go-expert.md=agents/go-expert.md \
  -n tools

# Referenciar no Helm
helm install chatcli deploy/helm/chatcli \
  --set agents.enabled=true \
  --set agents.existingConfigMap=chatcli-agents

Além de provisionar skills via ConfigMaps, você pode habilitar o Skill Registry para buscar e instalar skills de registries remotos diretamente no servidor:

helm install chatcli deploy/helm/chatcli \
  --set skillRegistry.enabled=true \
  --set skillRegistry.registryUrls="https://skills.mycompany.com/api/v1"

Depois de conectar ao servidor, use os comandos /skill para gerenciar skills:

/skill search kubernetes     # Busca em todos os registries
/skill install k8s-ops       # Instala no servidor
/agent skills                # Verifica que a skill está disponível

Quando os devs conectam, eles veem automaticamente os recursos do servidor:

Connected to ChatCLI server (version: 1.3.0, provider: CLAUDEAI, model: claude-sonnet-4-5)
 Server has 2 plugins, 2 agents, 3 skills available

Dicas de Operação

Logs do Servidor

# Docker
docker logs chatcli-server -f

# Kubernetes
kubectl logs -f deployment/chatcli -n tools

Health Check

# O Dockerfile inclui health check integrado
docker inspect chatcli-server --format='{{.State.Health.Status}}'

Monitoramento de Uso

Configure LOG_LEVEL=info no servidor para registrar cada request com provider e modelo utilizado.

Backup de Sessões

# Docker: volumes persistentes
docker cp chatcli-server:/home/chatcli/.chatcli/sessions ./backup/

# Kubernetes: PVC já configurado no Helm chart

Sessões Remotas

Quando conectado a um servidor, os comandos /session interagem com ambos local e remoto:

/session save pergunta onde salvar: local, remoto ou ambos
/session list exibe sessões de ambos em seções separadas
/session load busca em ambos; se encontrada nos dois, pergunta de qual carregar
/session delete verifica ambos; se encontrada nos dois, pergunta de qual remover

Isso permite que devs salvem sessões no servidor para compartilhar com a equipe, ou localmente para uso offline.

Resumo

Componente	Configuração
Servidor	`chatcli server --token X`
Cliente	`chatcli connect --token X`
Env Vars	`CHATCLI_REMOTE_ADDR`, `CHATCLI_REMOTE_TOKEN`
TLS	`--tls-cert`, `--tls-key` (servidor) / `--tls` (cliente)
Credenciais	Servidor (padrão) ou cliente (`--llm-key` / `--use-local-auth`)
Agents/Skills	`agents.enabled=true` + ConfigMap (Helm) ou `agents.configMapRef` (Operator)
Plugins	`plugins.enabled=true` + init container ou PVC (Helm) ou `plugins.image` (Operator)

Cookbook

​Cenário

Equipe Pequena

API Keys Corporativas

Acesso via Terminal

Autenticação Flexível

​Dicas de Operação

​Resumo

Cenário

Dicas de Operação

Resumo