Documentación / 05

CLI y diagnóstico de Devin Pocket

El CLI de Devin Pocket inicia y supervisa el servidor local, muestra su estado y ofrece registros, doctor y diagnóstico de modelos. Sin comando inicia en 127.0.0.1:7777. Los flags prevalecen sobre config cuando corresponde. Si algo falla, empieza por doctor, revisa logs y el reporte descargable de Diagnóstico antes de compartir detalles sin información sensible.

Última actualización ·Node.js 22+

Antes de empezar

  • Pocket instalado y Node.js 22+.
  • Devin CLI en PATH y cuenta autorizada para operaciones del agente.

Paso a paso

  1. 01

    Inicia con opciones de workspace

    El directorio ACP es el actual por defecto. --agent prevalece sobre DEVIN_POCKET_AGENT y este sobre agentCommand de config.

    devin-pocket start --cwd "$HOME/project" --port 7778 --no-open
    devin-pocket status
  2. 02

    Diagnostica fallos

    doctor revisa runtime, CLI/auth/ACP, rutas, puertos y permisos. logs muestra 100 entradas por defecto. models actualiza precios; requiere login y algunos precios pueden faltar.

    devin-pocket doctor
    devin-pocket logs -n 100
    devin-pocket logs -f -n 50
    devin-pocket models
  3. 03

    Revisa configuración

    Config opcional en ~/.config/devin-pocket/config.json salvo XDG_CONFIG_HOME. Si falta o es inválida usa valores por defecto. Las preferencias de interfaz viven en el navegador aunque el esquema acepte theme/lang/showThoughts.

    devin-pocket help
    devin-pocket version
  4. 04

    Reinicia o detén deliberadamente

    Restart crea supervisor con las opciones indicadas; no recuerda flags anteriores ni conserva foreground. Si el puerto está ocupado, detén la instancia o elige otro.

    devin-pocket restart --port 7778 --no-open
    devin-pocket stop

Referencia de comandos

ComandoFunción
devin-pocket start
Inicia el supervisor (por defecto)
devin-pocket stop
Detiene supervisor/servidor registrado
devin-pocket restart
Detiene e inicia con opciones indicadas
devin-pocket status
Muestra estado, uptime y URL
devin-pocket logs
Entradas recientes del registro
devin-pocket doctor
Revisa runtime, CLI, auth, ACP y rutas
devin-pocket models
Actualiza catálogo y muestra precios/debug
devin-pocket open
Abre 127.0.0.1 con el puerto elegido
devin-pocket version
Muestra versión del paquete
devin-pocket help
Muestra la ayuda

Flags

FlagDefectoSignificado
--port N7777Puerto
--host HOST127.0.0.1Escucha sin auth de clientes
--cwd DIRprocess.cwd()Workspace ACP
--agent CMDdevin acpComando agente
--no-openfalseNo abre navegador
--devfalseForeground, sin navegador, marca dev
--foregroundfalseStart en terminal actual
-f, --followfalseSigue registros
-n N100Cantidad de entradas
-h, --help—Muestra ayuda
-v, --version—Muestra versión

Configuración y entorno

~/.config/devin-pocket/config.json

{
  "port": 7777,
  "host": "127.0.0.1",
  "agentCommand": "devin acp",
  "workspaces": []
}

Valores por defecto. Tema, idioma y pensamientos se guardan realmente en el navegador. Las rutas respetan XDG. No existen DEVIN_POCKET_PORT ni DEVIN_POCKET_HOST.

VariableValor / ejemploFunción
DEVIN_POCKET_AGENTdevin acpComando agente; gana --agent
DEVIN_POCKET_VERBOSE1Duplica logs en stderr
DEVIN_POCKET_MODELS_FILE/path/models.jsonFixture de catálogo
XDG_CONFIG_HOME~/.configRaíz config
XDG_STATE_HOME~/.local/stateLogs, PID y títulos
XDG_CACHE_HOME~/.cacheCaché de modelos
DEVIN_POCKET_SUPERVISOR1Interno; no configurar
DEVIN_POCKET_DAEMON1Interno; no configurar
DEVIN_POCKET_LOCAL1Instalador: código local

Archivos de estado: devin-pocket.log, devin-acp.stderr.log, daemon.out.log, server.pid, titles.json bajo la raíz XDG de estado / devin-pocket. Caché: models.json bajo la raíz XDG de caché / devin-pocket (24 horas). Cada workspace de config tiene path, name y lastUsedAt numérico opcional.

Desde código o tarball

Usa Node.js 24 actualizado para desarrollo y pnpm 12.6.0 fijado. Tras compilar usa npm para enlazar el tarball global: pnpm add -g <tgz> ha sido un no-op silencioso en algunos entornos proot.

git clone https://github.com/BOTOOM/devin-pocket.git
cd devin-pocket
npm i -g pnpm@12.6.0
pnpm install --frozen-lockfile
pnpm run build
pnpm pack
npm install -g ./devin-pocket-*.tgz
devin-pocket doctor
devin-pocket start
npm install -g /path/to/devin-pocket-VERSION.tgz

Ten en cuenta

  • Diagnóstico incluye reporte JSON descargable, registros y detalles de modelos. Puede contener rutas: revísalo y quita datos sensibles.
  • Si falla el login usa devin auth login en el servidor. Las sesiones dependen de ACP/workspace; Pocket no guarda otra base de datos de sesiones.
  • Imágenes de hasta 1.5 MB; los mensajes codificados también tienen límite WebSocket de 2 MiB.

Fuente de verdad: el README y la implementación de Devin Pocket.

README