⌨ Cliente CLI del Agente Atrivia

Usa el agente desde tu terminal — más rápido si tecleas mucho. Solo requiere Python 3.9+ (viene con macOS y la mayoría de Linux).

Instalación

1

Descarga e instala el script

En tu terminal, pega este comando:

mkdir -p ~/.local/bin && \
curl -fsSL https://agente.atrivia.net/static/agente -o ~/.local/bin/agente && \
chmod +x ~/.local/bin/agente

Asegúrate de que ~/.local/bin esté en tu PATH. Si no, agrégalo a tu .zshrc o .bashrc:

export PATH="$HOME/.local/bin:$PATH"
2

Genera un token

Vuelve a la UI web, click en ⌨ Mis tokens CLI en el sidebar, y Generar. Copia el token (se muestra una sola vez).

3

Configura el CLI

agente login

Te pide el host (deja el default) y el token. Lo guarda en ~/.config/agente-atrivia/config.json (chmod 600).

4

Usa el agente

agente chat

Abre un REPL. Dentro de la conversación:

Otros comandos útiles

agente sessions                       # ver últimas conversaciones
agente resume a1b2c3d4                # retomar por prefijo del ID
agente whoami                         # tu usuario + rol
agente logout                         # borrar credenciales

Ejemplo de uso

$ agente chat
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Agente Atrivia  (https://agente.atrivia.net)
  Eddy Urena · superadmin
  Sesión: 7f3a9d21  Nueva conversación
  Ctrl+D o /quit para salir · /help para comandos
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

tú ❯ analiza el ticket 1042

agente ❯
El ticket 1042 es de Grupo B. El cliente reporta error en la
secuencia NCF desde ayer. Revisando el chatter...
  ⚙ get_ticket, get_ticket_messages

tú ❯ _

Problemas comunes

"Token rechazado" — el token fue revocado o expiró. Genera uno nuevo desde la UI y vuelve a agente login.

"No se pudo conectar" — probablemente problema de red o el servicio está caído. Revisa curl https://agente.atrivia.net/health.

Comando agente no encontrado — ~/.local/bin no está en tu PATH. Ver paso 1.

← Volver al agente