23/Documentation
Resolución de problemas
Síntomas descritos con los términos exactos que se buscarían
Síntomas a continuación, en orden; busque el suyo en la página. Os { NotFound } desde herdr plugin · update indica "not currently on a branch" · tailscale serve failed · no responde (el servicio no inicia) · el teléfono no puede abrir la URL · la página carga pero permanece vacía (página en blanco, 403) · una solicitud de contraseña no acepta la respuesta · no hay notificaciones push · desaparece tras reiniciar el sistema · un panel se queda bloqueado en un ancho reducido · Collie se niega a abrir una ventana de tmux · tmux list: output did not parse · herdr plugin list muestra la versión anterior · interfaz desactualizada tras recompilar · Guardé una máquina en Herdr y el teléfono no la muestra · una actualización iniciada desde el teléfono se queda en staging · una actualización desde el teléfono en macOS deja Collie descargado · en macOS, collie status indica "loaded, not running" · un panel no muestra el chip de prompt-cache · el Historial de un panel de Kiro se abre vacío · un panel no tiene Chat ni Historial · un panel nuevo de Codex indica que aún no tiene historial · el teléfono indica que Collie no puede leer una pantalla que el agente no está mostrando · el envío falló 3 veces y el teléfono ofrece un informe · un agente aparece atenuado en la página New · Start indica que no existe la carpeta, o que no pudo confirmar · walky talky: se rechaza el envío, "run this inside a pane" · walky talky: el mensaje permanece en la bandeja de entrada y no se escribió · walky talky: "no log record on this machine" · walky talky: la habilidad está obsoleta · un agente duradero no aparece o indica Inaccesible.
herdr plugin … falla con Error: Os { code: 2, kind: NotFound, message: "No such file or directory" } (falla la instalación del plugin, falla la invocación de la acción). Esto no es un problema de Collie; significa que el servidor de Herdr no está en ejecución, por lo que su CLI no puede acceder al socket de control (~/.config/herdr/herdr.sock). La señal es el error sin procesar Os {…}: un servidor accesible responde a problemas de ruta/manifiesto con JSON estructurado (p. ej., plugin_manifest_not_found), por lo que un Os { NotFound } simple indica un fallo de conexión al socket antes de examinar Collie o la ruta. Afecta a link, install, action invoke (todos los subcomandos que se comunican con el servidor), mientras que herdr plugin --help sigue funcionando (nunca abre el socket). Solución: inicie Herdr primero (herdr server &, o simplemente abra la TUI de Herdr, que inicia el servidor), confirme que ls ~/.config/herdr/herdr.sock existe ahora e intente la instalación de nuevo. herdr plugin list es una comprobación rápida: si devuelve el mismo error, el servidor está caído.
update falla con You are not currently on a branch. Una instalación de GitHub realizada antes de 0.23.1 (#63): herdr plugin install desacopla en lugar de clonar, por lo que el update antiguo no tenía una rama donde hacer git pull. La corrección se incluye en la copia que repara, por lo que requiere una reinstalación para aplicarse: Si eso falla con "You are not currently on a branch" contiene los tres comandos.
start muestra note: tailscale serve failed. Collie funciona correctamente (sigue activo en 127.0.0.1); únicamente el ingreso a la tailnet no se inició, y el propio error de tailscale figura en el terminal sobre la nota. Causas habituales: el usuario no es el operador de Tailscale (sudo tailscale set --operator=$USER), se cerró la sesión del nodo (tailscale up), o bien (en dominios de tailnet Headscale / .internal) los certificados HTTPS no están disponibles, que es exactamente para lo que sirve COLLIE_SERVE_MODE=http: configúrelo en .env, luego bin/collie restart. Verifique con tailscale serve status.
serve indica HTTPS certificates are not enabled on this tailnet. No se publicó nada y no hay nada en espera. Abra consola de administración, active "Enable HTTPS" y vuelva a ejecutar collie serve. En dominios Headscale / .internal no hay certificados que activar; use COLLIE_SERVE_MODE=http en su lugar.
El banner muestra ⚠ Collie isn't answering on :8787 yet (el servicio no se inicia, conexión rechazada). El servicio se inició pero el servidor HTTP no responde al sondeo. Revise la unidad primero (systemctl --user status collie) y luego bin/collie logs (o journalctl --user -u collie -f para verlo en directo) para identificar la causa: lo más común es que el puerto ya esté ocupado (configure COLLIE_PORT en .env, luego bin/collie restart, que también vuelve a ejecutar tailscale serve contra el nuevo puerto) o que la primera compilación haya fallado (el registro lo indica; corrija y ejecute bin/collie build). La unidad se reinicia automáticamente cada 5 s, por lo que una vez corregida la causa suele recuperarse por sí sola.
El teléfono no puede abrir la URL de la tailnet. Revise la lista en orden: (1) el teléfono ejecuta la aplicación Tailscale y está conectado a la misma tailnet que el host; (2) está abriendo la URL tailnet del banner (bin/collie url), no la de local (http://127.0.0.1:8787 solo funciona en el propio host); (3) MagicDNS está habilitado en la configuración de DNS de su tailnet (la URL es un nombre MagicDNS); (4) el host está en línea: verifique tailscale status en el host o haga ping al host desde la aplicación Tailscale del teléfono; (5) la política de su tailnet realmente admite un par en este nodo (si no lo hace, el banner ahora lo indica debajo de la línea tailnet, y nada más lo hará: el punto de entrada está publicado correctamente, el certificado es válido y curl desde el propio host devuelve 200, porque loopback nunca pasa por el filtro de paquetes). Dos factores hacen que este caso sea especialmente confuso: tailscale ping tiene éxito (los pings de descubrimiento omiten las ACL), y el tráfico bloqueado se descarta en lugar de ser rechazado, por lo que el teléfono simplemente se queda esperando y parece que el servidor está caído. Corríjalo en su política de ACL (<https://login.tailscale.com/admin/acls> en Tailscale; su archivo de política en Headscale). La comprobación es del tipo mejor esfuerzo y deliberadamente prudente: solo advierte cuando el filtro de este nodo admite nada (lo que también puede significar que ningún otro dispositivo se ha unido a la tailnet todavía) y permanece en silencio cuando no puede determinarlo.
La página carga pero se queda vacía (página en blanco, pantalla blanca); Las llamadas a la API fallan 403 cross-origin rejected. Se está accediendo a Collie a través de un origen no esperado: un dominio personalizado o un proxy que reescribe Host. Permita el origen público exacto con COLLIE_ALLOWED_ORIGINS (consulte Configuración), o configure el proxy para que reenvíe Host sin cambios (el cuarto requisito de proxy en docs/deployment.md).
Una solicitud de sudo (o frase de contraseña de SSH, o gpg) no acepta su respuesta. Use Type en la fila de acciones sobre el teclado, no Send. Send verifica lo que escribió leyéndolo de la pantalla antes de pulsar Enter (#34), y una solicitud de contraseña desactiva el eco, por lo que no hay nada que leer; Type envía las pulsaciones directamente al panel, Enter incluido. Nada de lo que escriba en Type se almacena, se refleja en un borrador ni se restaura después, y en cuanto Collie detecta una solicitud de contraseña también descarta el borrador guardado (#103).
No llegan notificaciones push. Dispare una manualmente: bin/collie push-test. Tres causas, en el orden en que el comando las distingue: push indica que está deshabilitado (las claves nunca llegaron al puente; ejecute push-keys y reinicie, consulte Web Push); indica que no hay dispositivos suscritos (este teléfono nunca los habilitó en Configuración → Alertas); o informa un envío y no llega nada (el teléfono está en un origen HTTP sin cifrar, que no es un contexto seguro; Configuración lo marca insecure).
Collie desaparece después de reiniciar. En Linux esto casi siempre se debe a la persistencia de sesiones de usuario, por lo que debe ejecutar loginctl enable-linger $USER (Persistencia tras reinicios). En macOS, el agente de launchd se inicia en login, así que verifique que la sesión esté realmente iniciada (no en la ventana de inicio de sesión) y que el agente esté cargado: launchctl print gui/$(id -u)/herdr.collie.
El terminal de un panel está bloqueado en un ancho reducido y una aplicación a pantalla completa en su interior se comprime (Copilot CLI, top, cualquier TUI dibujada en una franja mientras el resto del mirror permanece en blanco). El terminal del panel tiene ese ancho reducido, y Collie lo reproduce fielmente. El ancho de un panel de Herdr proviene de su rectángulo en la cuadrícula de divisiones de la pestaña, por lo que un panel que comparte pestaña recibe una parte de las columnas. Herdr aplica la geometría del panel solo mientras un cliente de escritorio está conectado (herdr#1709): sin nada conectado, cerrar una división deja el panel restante bloqueado en el ancho reducido anterior, y pane.zoom y pane.resize a través del socket tampoco lo modifican. Collie no puede corregir esto desde su lado; no escribe en absoluto la geometría del panel (ADR 0031: el teléfono mueve el terminal del operador solo al pulsar Show in terminal). No hay nada específico de la aplicación: top en un panel de 54 columnas se ve idéntico. Para medirlo, ejecute tput cols en el panel. Ese es el ancho real, y puede no coincidir con lo que informa herdr pane layout. Para solucionarlo, conecte un cliente de Herdr y luego amplíe o redimensione el panel allí (herdr pane zoom <pane-id> --on mueve el terminal una vez que hay algo conectado), o cierre el panel y abra uno nuevo (#167).
Collie se niega a abrir una ventana de tmux (el nueva pestaña del teléfono responde rechazando y especificando window-size). No es un fallo en la solicitud: en versiones de tmux inferiores a 3.7, generar una ventana mientras el window-size del servidor es manual bloquea el servidor completo (tmux #4849, corregido en 3.7), y un servidor bloqueado arrastra consigo a todas las ventanas. Collie lo rechaza y nombra la versión de tmux detectada. La solución es la línea que imprime (tmux set -g window-size latest en ese servidor) o tmux 3.7. Nada más se ve afectado: cualquier otra acción en esos paneles continúa funcionando (Requisitos tiene la misma advertencia).
Collie registra tmux list: output did not parse y el panel se muestra vacío. No es una caída: algunas versiones de tmux (3.4, no 3.6b) escapan el separador que lee este adaptador al salir de un listado de -F. Collie ahora lee ambos formatos, por lo que un listado que se analiza en cero filas se reporta como un error de mux en lugar de almacenarse como un herd vacío; la línea de error indica la versión de tmux y cuántas líneas vio. Una segunda causa era la configuración regional: al iniciarse sin una configuración regional UTF-8 (un contenedor mínimo, una unidad de systemd), tmux reemplaza ese separador con _ en lugar de escaparlo. Collie ahora ejecuta cada comando de tmux con -u, por lo que el listado ya no depende de LANG ni de LC_ALL. Si el problema persiste, anote la versión de tmux -V y abra una incidencia; la corrección corresponde al adaptador, no a su .env.
herdr plugin list muestra la versión anterior después de un update. Comportamiento esperado: Herdr guarda en caché el manifiesto leído durante la instalación o el enlace. La referencia de lo que se está ejecutando es la marca de compilación del pie de página o bin/collie version. Para un clon vinculado, update vuelve a enlazar y se repara de forma automática (fuerce el proceso con herdr plugin link "$(pwd)"); en Herdr ≥0.8.0, el manifiesto se vuelve a leer desde el disco de todos modos.
El teléfono muestra una interfaz desactualizada tras una recompilación. La caché de service-worker de una PWA es por origen, por lo que acceder a Collie desde dos orígenes (un dominio personalizado y la dirección sin procesar de host:8787) genera dos instalaciones, cada una guardando su propio paquete en caché. El pie de página marca de compilación (vX.Y.Z · sha · time) muestra el paquete en ejecución; Collie informa lo que sirve a través del encabezado X-Collie-Build y /api/config. Si no coinciden, el pie de página ofrece "nueva compilación: toque para actualizar." De lo contrario, vuelva a abrir la PWA un par de veces (el SW se actualiza de forma automática) o borre los datos de sitio de ese origen. Práctica recomendada: elegir un único origen HTTPS y mantenerlo. (Sobre HTTP plano el SW no puede registrarse; siempre está actualizado, pero sin funciones de PWA).
Guardé una máquina en Herdr y el teléfono no la muestra. Comportamiento esperado. Las máquinas guardadas de Herdr pertenecen a la lista de su propio cliente, y un crew pertenece a Collie; ninguna lista alimenta a la otra. Para acceder a esa máquina desde el teléfono, regístrela: collie crew add <ssh-host> en el lead, luego collie restart en el lead y collie crew status para verificar el enlace. Agregar o eliminar una máquina en Herdr no cambia nada en el crew (Máquinas de Herdr y el crew).
Un panel no muestra el chip de prompt-cache. Uno de tres motivos, y collie doctor permite distinguirlos. El harness del panel no tiene adaptador de journal, lo cual indican sus líneas integration-<agent> y journal-roots. El panel nunca reportó una sesión, lo cual lista su línea agent-sessions por ID de panel. O el agente aún no ha tomado un turno, lo cual no es un error: no se muestra nada antes de medirlo, por lo que el chip aparece con la primera respuesta del agente. Un harness cuyo proveedor no publica el tiempo de vida de la caché tampoco muestra nada, y cache-claims lista cada regla incluida en esta compilación.
El Historial de un panel de Kiro se abre vacío. Verifique que el Kiro del panel mantenga un bloqueo de sesión:
cat ~/.kiro/sessions/*/*/.lockHerdr no nombra ninguna sesión para un panel de Kiro, por lo que Collie la encuentra mediante el bloqueo que mantiene el Kiro en ejecución. Esto funciona únicamente en Herdr, el único multiplexor que enumera los procesos en primer plano de un panel, y solo cuando se ejecuta exactamente un proceso de Kiro allí. De lo contrario, el Historial indica que el panel no tiene una sesión de agente.
Collie lee sesiones de Kiro V3, iniciadas con --v3 o --agent-engine v3, o con V3 configurado como motor en los ajustes propios de Kiro; por lo tanto, inicie Kiro de nuevo de esa manera en ese panel. Kiro no tiene ningún gancho de Herdr que instalar. Si sus sesiones residen en otro lugar, defina kiro_root y luego ejecute collie restart.
Un panel muestra la terminal donde se esperaba Chat. Chat es la opción predeterminada para un panel de agente, por lo que ocurre una de dos cosas. Este dispositivo eligió la terminal anteriormente: abra el menú ⋮ del panel y pulse Vista de chat. O bien el panel no tiene sesión ni registro para leer. Un panel nuevo muestra Chat con "Send a message to start" y recurre a la terminal cuando su primer turno termina sin nada que leer, o cuando formula una pregunta primero; la fila del menú indica qué parte falta y la siguiente entrada detalla los pasos.
Un panel no tiene Chat ni History, y el menú ⋮ indica que el panel no nombró ninguna sesión. Chat e History leen el registro de sesión del agente, y Collie solo encuentra el registro cuando el agente reporta su sesión a través del multiplexor. En Herdr, ese reporte proviene de la propia integración del agente, por lo que una integración ausente u obsoleta oculta ambos elementos sin ningún otro síntoma. collie doctor nombra el panel en agent-sessions y la corrección en integration-<agent>.
- Ejecute
herdr integration status. Si el agente esnot installedooutdated, ejecuteherdr integration install <agent>. Oh My Pi esompy pi espi: cada uno requiere el suyo propio. - Reinicie el agente en ese panel. Un agente carga su hook al iniciarse, por lo que uno que estaba en ejecución durante la instalación seguirá sin reportar nada.
- Si el hook está actualizado y un panel reiniciado aún no reporta nada, verifique si el agente se inició desde un shell abierto por otro agente. El hook de Oh My Pi no se activa si hereda
OMPCODE=1del agente principal. Inícielo desde una terminal limpia.
En tmux, zellij y tern solo Claude Code reporta una sesión, a través de los hooks de beacon de Collie. Ejecute collie hooks install claude (Collie escribe hooks en la propia configuración de Claude). Los demás agents no tienen Chat ni History allí.
Un panel nuevo de Codex indica que aún no tiene historial. Comportamiento esperado hasta su primer turno. Codex informa su sesión a Herdr únicamente cuando se envía el primer prompt, no al iniciar, por lo que un panel nuevo no tiene sesión ni enlace al historial hasta ese momento. collie doctor incluye dicho panel bajo agent-sessions como no informado aún, y no lo contabiliza como fallo. Si el aviso sigue presente después de que Codex haya respondido, abra /hooks en Codex. Cuando sus hooks cambian, Codex solicita revisarlos, y la opción "Continue without trusting" desactiva el hook de Herdr mientras herdr integration status todavía indica que está vigente. Confíe en el hook allí, o ejecute herdr integration install codex e inicie una nueva sesión.
El teléfono indica que Collie no puede leer un diálogo, o un envío no llega al cuadro de entrada, mientras el agente en el escritorio muestra su prompt habitual. Collie interpretó incorrectamente la pantalla, por lo general porque el agente modificó el modo en que la dibuja. Abra una incidencia con el texto sin procesar de la pantalla, que muestra lo que una captura no puede reflejar (los colores y el texto atenuado que Collie lee). Busque el identificador del panel con herdr pane list y luego ejecute
herdr pane read <pane-id> --source recent --lines 200 --format ansi > pane.txtmientras el teléfono siga mostrando el problema, y adjunte pane.txt junto con la versión del agente (claude --version, codex --version, etcétera). El archivo contiene el texto de la terminal; revíselo antes y elimine cualquier dato privado.
El envío falló 3 veces y el teléfono ofrece un informe. Tres envíos consecutivos en un panel fallaron por una causa atribuible a Collie: no pudo leer o escribir en el cuadro de entrada, el texto entró pero no fue seguido por Enter, o se perdió el seguimiento del envío. Un rechazo de protección (un borrador en el cuadro, un turno en curso, un diálogo abierto) no cuenta. Pulse Informe en la tarjeta. La hoja muestra la incidencia completa antes de enviar nada: las versiones de Collie y del agente, el multiplexor y los códigos de cada envío fallido. No contiene texto escrito ni capturas de pantalla a menos que active Incluir lo que escribí o Incluir la pantalla. La pantalla corresponde a las últimas 40 filas del panel con patrones de secretos conocidos enmascarados; revísela de todos modos, ya que la incidencia es pública. Abrir en GitHub abre el formulario completado en el navegador, bajo su propia cuenta de GitHub, y Copiar informe copia el mismo texto. Pulse ¿Ya se ha informado? primero para buscar una incidencia con la misma línea de firma. El menú del panel y Ajustes → Sistema abren la misma hoja en cualquier momento. La cruz cierra la tarjeta en ese panel hasta que un envío vuelva a funcionar. El panel de un miembro del equipo no ofrece informes todavía; use los pasos descritos arriba.
Una actualización iniciada desde el teléfono se queda en staging. En Collie hasta la versión 1.6.0, una actualización pulsada en el teléfono podía preparar la nueva versión en staging y luego detenerse: el runner que realiza el reemplazo nunca se iniciaba, el servicio continuaba ejecutando la versión anterior y el registro de ejecución se quedaba en staging manteniendo el bloqueo. La señal consiste en tres hechos juntos: collie update --status reporta staging (o, tras diez minutos, interrupted — the updater is gone), el directorio de versión para la nueva versión existe bajo versions/, y el registro del runner en ~/.config/collie/collie.log tiene 0 bytes. Un collie update ejecutado en una shell en la misma máquina siempre funcionaba, lo cual es el mismo defecto visto desde el otro lado. Está corregido a partir de la siguiente versión: la transferencia ahora espera a que el gestor de usuarios confirme el runner, y una transferencia rechazada se reporta como un fallo con el motivo del propio gestor.
Para desbloquear una máquina que ya está atascada, no haga nada durante diez minutos: una ejecución cuyo actualizador desapareció deja de bloquear un reintento diez minutos después de su última transición, y la siguiente pulsación continúa. Para desbloquearla de inmediato, elimine el registro, el bloqueo y el archivo de progreso de staging, luego revise lo que indica --status:
collie update --status # note the pid it names
ps -p <pid> -o command= # empty output: the updater really is gone
rm -f ~/.local/state/collie/update.json ~/.local/state/collie/update.lock
rm -f ~/.local/state/collie/update-staging-*.log
collie update --status # "no update has run on this install yet"No existe un comando que limpie una ejecución obsoleta, y estos tres archivos constituyen todo el estado que deja un staging detenido. Una instancia con sufijo los mantiene en ~/.local/state/collie-<name>/. Nunca elimine estos archivos mientras una actualización se esté ejecutando realmente, y verifique el pid primero: un actualizador activo cuyo bloqueo haya sido eliminado modificará current sin nada que lo proteja. No modifique versions/. El directorio de la versión a medio preparar en staging es inofensivo, el reintento compilará en él de nuevo y la purga de retención eliminará lo que ya no sea necesario.
Una actualización desde el teléfono en macOS deja Collie descargado. Ejecute esto en el Mac:
collie restartEn Collie hasta la versión 1.8.x, una actualización pulsada en el teléfono podía detener el agente launchd y no volver a cargarlo, por lo que el teléfono perdía el servicio y launchctl print gui/$(id -u)/herdr.collie no encontraba nada. El runner compartía el grupo de procesos del agente, y reiniciar el agente lo interrumpía a mitad de camino. collie restart vuelve a escribir el plist del agente y lo carga. A partir de 1.9.0, el bridge inicia el runner en su propia sesión de proceso. Si después de eso una actualización desde el teléfono todavía descarga el agente, ejecute el mismo comando y añada una nota en #213.
En macOS, collie start finaliza pero collie status indica "loaded, not running". La tarea de launchd está cargada y no se ejecuta ningún proceso, por lo que el registro está vacío. Inicie la tarea manualmente:
launchctl kickstart gui/$(id -u)/herdr.collie
collie statusUna instancia con sufijo tiene su propia etiqueta, por ejemplo herdr.collie-next. A partir de 1.17.0, collie start y collie restart realizan este paso de forma automática y muestran una advertencia con este comando cuando no aparece ningún proceso. Si la tarea permanece como "loaded, not running" después de eso, consulte el registro con collie logs y luego añada una nota en #213.
Un agente aparece atenuado en la página New. El motivo aparece entre corchetes tras su nombre. "not installed" significa que la máquina no encontró el comando del agente en el PATH que usa su shell de inicio de sesión. En una shell de inicio de sesión de esa máquina, ejecute bash -lc 'command -v claude' (o el nombre del propio agente). Si no genera ninguna salida, instale el agente allí o corrija la línea del archivo de inicio de sesión de su shell que lo añade al PATH y vuelva a abrir la página. En un crew, compruebe la máquina seleccionada: cada member busca en su propio disco. "this machine runs an older Collie" significa que debe actualizar ese member (Iniciar algo en una máquina). "needs Herdr" y "only on" junto al nombre de una máquina corresponden al interruptor Nuevo worktree, no a un agente.
Start indica "There is no folder … on this machine" o "could not confirm the start". El primer caso indica que la carpeta no se encuentra en la máquina que ejecuta el inicio, por lo que no se inició nada. Un nombre sin un / o ~ inicial es una carpeta dentro de su directorio de inicio, de modo que projects significa ~/projects. Cree la carpeta o elija una de Recent. El segundo caso indica que el teléfono perdió la respuesta. Compruebe primero el panel, ya que el panel de tmux o terminal puede existir. Reintentar envía la misma petición y nunca abre un segundo panel (Iniciar un agente o una shell desde el teléfono).
Walky talky
Seis síntomas de walky talky son los más frecuentes. Cada uno dispone de un comando que muestra la causa (Walky talky).
collie walky send dice "run this inside a pane, or send from the phone". El comando se ejecutó fuera del panel de un agente, por ejemplo en un terminal estándar. Collie identifica al remitente a partir del entorno propio del panel. Se rechaza un envío sin panel. Ejecute el comando en el panel del agente o envíe desde el teléfono. En el panel de un agente, collie walky who marca su panel con (you). El error "no Collie bridge on this machine knows this pane" significa que otro Collie posee el panel. El error "no running Collie bridge answers" significa que el puente está caído: ejecute collie status.
El mensaje indica "held" y aún no se ha escrito. collie walky status <id> muestra "held: draft present" o "held: turn running". La casilla contiene un borrador o el agente está trabajando. Collie escribe el mensaje cuando la casilla queda libre o el turno termina, hasta un máximo de 60 minutos. No lo envíe de nuevo. Para darle paso ahora, envíe o borre el borrador en ese panel. Bajo un lead anterior, "queued (outcome known on the lead)" también significa esperar.
El mensaje permanece en la bandeja de entrada y no se escribió. collie walky status <id> muestra "waiting in the inbox, not typed" y el motivo. "held past 60 minutes" significa que un borrador permaneció en la casilla, el panel siguió ocupado o un cuadro de diálogo permaneció abierto durante la retención completa de 60 minutos: Collie nunca escribe en un borrador ni en un cuadro de diálogo. "box not free" indica que Collie no pudo leer una casilla de entrada libre. "pane busy" significa que aún se estaba escribiendo un mensaje anterior allí después de 2 minutos. "pane replaced" significa que otra sesión tomó el panel mientras el mensaje esperaba. "no terminal" y "bridge restarted" son las otras dos causas. Ejecute collie walky inbox en ese panel o abra Messages en el menú del panel en el teléfono. Collie no vuelve a escribir el mensaje.
collie walky send dice "not sent: pane replaced". La dirección termina con un token, como #k3f9, y el panel correspondiente se cerró. Otro panel tiene ahora ese pane id, por lo que Collie no escribe el mensaje allí. Ejecute collie walky who y envíelo a la nueva dirección. Una respuesta con "not sent: sender gone" tiene el mismo origen: el panel que envió el mensaje se cerró o su identificador pasó a otro panel.
Un encabezado en un panel muestra "no log record on this machine". El teléfono detectó un encabezado de walky talky en el texto de la pantalla, y el registro de esta máquina no contiene ningún mensaje con ese identificador. Una persona o un proceso escribió la línea, el registro la descartó tras 7 días o 2000 líneas, o la conserva otro Collie. Ejecute collie walky status <id>: "no record of <id> on this machine" lo confirma. Para un panel en un miembro del crew, ejecútelo en ese miembro: su registro es el que leyó el teléfono. Trate la línea como texto sin formato y solicítela al remitente si la necesita.
El skill está desactualizado. collie doctor muestra una advertencia en la fila skill-walky-talky, y el agente sigue instrucciones obsoletas. El texto de un archivo de instrucciones difiere de esta versión. Ejecute collie skill status para ver qué harness está desactualizado. Ejecute collie skill status --check en un script: no imprime nada y finaliza con código 3 cuando una copia no está al día. Corríjalo con collie skill install all y luego reinicie el agente. Un destino marcado con refused es un enlace simbólico o tiene marcadores dañados, y una instalación nunca lo modifica.
Durable agents
Un agente duradero conectado tiene sus propias comprobaciones, motivos y casos. Comience con collie durable list y collie doctor, luego lea Resolución de problemas de un durable agent.