CLI do Passe1 (fatia 2)

Seu passe de IA no terminal: valida a chave, conversa com streaming, lista modelos e skills, e aponta seus harnesses para o gateway.

Instalacao

curl -fsSL https://passe.dehor.com.br/cli/install.sh | sh

# depois use direto, de qualquer pasta:
passe1 login
passe1 chat "explique closures em 3 linhas"

Desenvolvedores (dentro do repo): pip install ./cli, ou rode sem instalar com python cli/passe1.py ....

Uso

# entrar uma vez (a chave fica em ~/.config/passe1/key, modo 600)
passe1 login
passe1 login sk-passe1-...

# conversar (uma pergunta, stdin ou REPL; /sair encerra, /limpar zera)
passe1 chat "explique closures em 3 linhas"
passe1 chat
passe1 chat --model mimo-v2.5 "oi"
echo "resuma isto" | passe1 chat

# skills locais (SKILL.md do Claude/Codex ou de ~/.config/passe1/skills)
passe1 skills
passe1 chat --skill revisor "revise este texto"
# no REPL: /skill NOME ativa, /skill mostra a ativa, /skill off desativa
# (a ativa fica salva e vale para as proximas sessoes)
# /model mostra o atual, /model ID troca sem sair do chat

# modelos (com visao e janela) e status (passe, validade, uso)
passe1 models
passe1 status
passe1 models --json   # saida maquina para scripts
passe1 status --json
passe1 logout

# apontar um harness para o Passe1 (faz backup do config atual)
passe1 setup claude
passe1 setup codex
passe1 setup verboo   # gera ~/.config/passe1/verboo.sh, importe com source

Opções globais: --base-url (aponta para outro gateway, ex. o local) e --versao. A variável PASSE1_MODEL troca o modelo padrão do chat.

Testes

pytest cli/tests -q   # sem rede (httpx MockTransport)

Notas

• A chave nunca aparece em log nem em erro: só os 4 últimos caracteres.
• O chat usa streaming (SSE); se o gateway responder JSON simples, a CLI entende mesmo assim.
• O REPL guarda historico em ~/.config/passe1/history (setas funcionam).
• setup codex pede export PASSE1_API_KEY=$(cat ~/.config/passe1/key) no terminal; setup verboo gera snippet para source (o Verboo CLI lê provedor por variável de ambiente).