Personnn Documentación P/

Personnn Code

Tu agente de código: en tu máquina, con tus cuentas. Y te recuerda.

Lee y edita archivos, corre comandos, navega por la web y delega tareas desde tu terminal. Elige qué modelo usar en cada sesión.

AGI-Lao programando en su portátil frente a montañas al atardecer

Instalación

Ejecuta estas líneas en tu terminal para instalar Personnn y abrir Code.

curl -fsSL https://personnn.com/install.sh | sh
personnn code

Si usas un modelo en la nube, abre /login para conectar tu cuenta. En un Mac con Apple Silicon también puedes configurar un modelo local con /local.

Tu primera vez acá

  1. Ejecuta el instalador y abre personnn code.
  2. Conecta tu cuenta con /login.
  3. Elige el modelo con /model y guárdalo con Ctrl+S.
  4. Pídele una tarea concreta: «Resume este repo y dime cómo correr las pruebas».
  5. Evalúa la respuesta con /rate 5 o deja una nota sobre qué mejorar.

Conecta tus cuentas

Dentro de Personnn Code, ejecuta /login y elige un proveedor. Si ya usas Antigravity, elige Google e inicia sesión con esa misma cuenta para acceder a los modelos Gemini disponibles.

También puedes autenticarte sin abrir la interfaz:

personnn code auth login anthropic
personnn code auth login openai-codex
personnn code auth login google
personnn code auth login nvidia --api-key

Comandos del chat

Escribe estos comandos dentro de una sesión de Personnn Code.

/help · /context
Lista los comandos disponibles o revisa qué consume el contexto de la sesión.
/rate <1-5> [nota]
Evalúa el último trabajo. Sin argumentos muestra tus votos.
/review · /personnn-diff
Revisa el último turno o explora el diff del repositorio.
/checkpoints · /undo
Consulta puntos de control y previsualiza una reversión antes de confirmarla.
/todo add <texto> · /todo done <id>
Agrega o marca pendientes de la sesión.

Trabajo automático

/loop <1-20> <tarea> · /goal <objetivo>
Repite una tarea o itera sobre un objetivo con comprobaciones.
/auto on · /auto off
Activa o desactiva el modo de permisos acotados. Las acciones sensibles siguen requiriendo aprobación.
/bg <comando> · /jobs · /job <id>
Corre un comando en segundo plano y consulta su estado.
/agents · /workspace
Consulta los agentes y procesos de tu sesión.
/handoff <proveedor/modelo> · /fallback <modelo,modelo…>
Cambia de modelo para retomar la tarea o configura alternativas ante límites de uso.
/evolve
Analiza los evals fallidos y propone mejoras a los skills.

Mantenimiento

/doctor · /update
Diagnostica el entorno o comprueba e instala una actualización.
/web · /local
Revisa las herramientas web o configura un modelo local en un Mac con Apple Silicon.
/router status · /router off
Consulta o desactiva el enrutamiento automático de modelos.
/links · /reportar
Abre enlaces con el teclado o prepara un reporte local para revisarlo antes de enviarlo.

Personas

Una persona adapta las instrucciones, los ejemplos y las fuentes que consulta el agente sin volver a entrenar el modelo. Usa /persona crear <nombre> o pídele al agente que la cree y vincule tu carpeta de documentos.

.personnn-personas/<nombre>/
├── PERSONA.md      reglas y estilo
├── conocimiento/   documentos consultables
├── dataset/        ejemplos
└── fuentes.json    fuentes de referencia

/persona lista tus perfiles, /persona <nombre> activa uno y /persona off lo desactiva.

Cron

Pídele a Personnn Code que programe un trabajo diario. Corre la primera vez que abras una sesión pasada la hora indicada. Si no abriste la sesión durante varios días, se hace una sola corrida de recuperación.

Revisa el estado con /cron, ejecuta un trabajo con /cron correr y usa los subcomandos pausa, seguir o quitar para administrarlo. Los reportes quedan en .personnn-cron/reportes/.

Herramientas del agente

Pídele al agente que busque en el repositorio, cambie archivos y verifique el trabajo con las pruebas del proyecto. También puede consultar la web, recuperar contexto anterior o delegar tareas independientes. En Code Mode puede combinar varias herramientas en un script JavaScript.

Desde la terminal

personnn code -p "resume este repo"
personnn code --mode json -p "resume este repo"
personnn code --session <id>
personnn code --auto-model
personnn code profiles
personnn code doctor

Usa -p para una respuesta directa, --mode json para integrar la salida con otro programa y --session para reabrir una sesión guardada.

Personnn Terminal

personnn code terminal configura el tema de Personnn en Ghostty, iTerm2 o WezTerm. Si tu terminal no admite enlaces clickeables, usa /links para abrirlos con el teclado.

Privacidad

El agente lee y edita archivos localmente. Si eliges un modelo remoto, los fragmentos de archivo incluidos en el contexto de la tarea pueden enviarse a ese proveedor. Las herramientas web también realizan solicitudes externas.

Una vez instalado, el modelo local Buddy 9B puede responder sin conexión. Los votos, personas y trabajos cron se guardan como archivos locales; /reportar prepara un reporte que tú decides si compartir.

Personnn Compute

Próximamente para las rutinas de Code: ejecuta trabajos largos en una máquina de Personnn sin tener que dejar tu terminal abierta. Mientras tanto, el cron local corre al abrir una sesión.