Metadata-Version: 2.4
Name: passe1
Version: 0.2.3
Summary: CLI do Passe1: seu passe de IA no terminal.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27

# 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

```sh
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

```sh
# 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

```sh
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).
