Atlas integrado · v4.7 · 23 septiembre 2026
Atlas: terminales, Herdr/Moshi, DSH y OpenCode en ia-lab
Auditoría de solo lectura realizada el 2026-09-23 sobre ia-lab (100.75.152.118). No se reiniciaron servicios, no se ejecutaron instaladores y no se modificaron archivos. Se omitieron valores de Environment=, tokens, claves, cookies, auth state, sesiones y contenido de panes/historial.
Consulta también todos los perfiles y resultados históricos y el índice de archivos del kit.
- Atlas: terminales, Herdr/Moshi, DSH y OpenCode en ia-lab
- 1. Entrada segura y límites
- 2. Herdr: instalación, servicio y teclado
- 3. tmux: la tecla Ctrl+A que sí está configurada
- 4. Ventanas tmux observadas
- 5. Moshi-hook: estado y pasos de activación
- 6. DeepSeek Harness / DSH web profile
- 7. OpenCode: configuración real frente a la documentación
- 8. vLLM/SGLang y lo que realmente existe
- 9. llama.cpp / FAALL
- 10. Receta reinstalable de máquina nueva (plan, no ejecutado)
1. Entrada segura y límites
ssh lab@HOST_IA_LAB
Identidad observada: hostname ia-lab, usuario lab, reloj remoto 2026-09-23T21:51:53+00:00. Antes de cualquier cambio, abrir una terminal separada y conservar la sesión llama como referencia. La auditoría consultó sólo estados, metadatos, nombres de ventanas y ayuda CLI; no hizo tmux capture-pane, history, journalctl, lectura de logs de contenido ni lectura de secretos.
2. Herdr: instalación, servicio y teclado
Estado observado
/home/lab/.local/bin/herdrexiste, ELF estático x86-64,herdr 0.9.1./home/lab/.config/systemd/user/herdr.serviceejecuta/home/lab/.local/bin/herdr server,Restart=on-failure; sus variablesEnvironment=fueron redactadas.systemctl --user is-enabled herdr.service→enabled;is-active→active.herdr status server→running, versión0.9.1, endpoint/protocolo privado compatibles, socket/home/lab/.config/herdr/herdr.sock./home/lab/.config/herdr/config.tomlfijakeys.prefix = "ctrl+b", mouse/copia por selección activados, scrollbars y reanudación de agentes.
Instalación oficial de referencia (no ejecutada): el README del proyecto publica curl -fsSL https://herdr.dev/install.sh | sh, compilación desde https://github.com/ogulcancelik/herdr y el flujo de workspaces. Ver herdr-terminal y quick start. Conviene fijar una release y revisar el binario antes de sustituir el 0.9.1 local; no asumir que el instalador actual conserva esa configuración.
Operación prevista:
herdr # crea o conecta al servidor persistente
herdr status server # consulta, no cambia estado
herdr session list # listar sesiones si se necesita seleccionar
herdr session attach <nombre> # adjuntar una sesión nombrada
La documentación pública usa Ctrl+B q para salir del cliente Herdr dejando procesos y sesión vivos. En el host, Herdr tiene prefijo Ctrl+B, no Ctrl+A.
3. tmux: la tecla Ctrl+A que sí está configurada
El archivo /home/lab/.tmux.conf contiene set -g prefix C-a, bind C-a send-prefix y un indicador de estado CTRL+A. Por tanto, las operaciones tmux son:
Ctrl-A d detach del cliente tmux; procesos continúan
Ctrl-A c nueva ventana
Ctrl-A n/p siguiente/anterior ventana
Ctrl-A w selector de ventanas
No confundir Ctrl-A d (tmux) con Ctrl-B q (Herdr). La configuración Herdr y tmux pueden estar anidadas; pulsar el prefijo del multiplexor exterior primero y comprobar el indicador visible.
4. Ventanas tmux observadas
Se consultaron nombres/contadores, no contenido de panes:
harness: General, Log, Check, Test, Monitior (6 panes)
llama: General, Log, Check, Test, Monitor (6), OpenCode (6), Codex
sglang: General, Log, Check, Test, Monitor (6), OpenCode (6), Codex
vllm: General, Log, Check, Test, Monitor (6), OpenCode (6), Codex
Sesiones existentes: harness, llama, sglang, vllm. La ventana harness tiene el typo visible Monitior; no se corrigió. llama es la referencia activa y no debe cerrarse ni reutilizarse para instalar runtimes.
5. Moshi-hook: estado y pasos de activación
Estado observado
- La unidad usa
/home/lab/.local/bin/moshi-hook serve; ese binario existe, es ELF Go estático y devuelvemoshi-hook version 0.3.26. /home/lab/.config/systemd/user/moshi-hook.serviceestáenabledyactive.moshi-hook status→paired; hostia-lab; servidor Moshi Pro adjunto; socket/run/user/1000/moshi-hook.sock.moshi-hook probe→installed: true,running: true,gateway: true, versión0.3.26.- Hooks actuales reportados: Claude
/home/lab/.claude/settings.json, Codex/home/lab/.codex/hooks.json, OpenCode/home/lab/.config/opencode/plugins/moshi-hooks.ts. No se leyó su contenido.
Instalación oficial de referencia (no ejecutada): curl -fsSL https://getmoshi.app/install.sh | sh; servicio Linux moshi-hook service install; verificación moshi-hook service status. La documentación oficial explica que el daemon mantiene el socket local, gateway 127.0.0.1:24543 y WebSocket de Moshi: Install moshi-hook. La unidad existente es una instalación manual/gestionada de systemd; no instalar encima sin una decisión explícita.
Comprobaciones sin cambio de estado:
/home/lab/.local/bin/moshi-hook version
/home/lab/.local/bin/moshi-hook status
/home/lab/.local/bin/moshi-hook probe
/home/lab/.local/bin/moshi-hook service status
moshi-hook install, pair, service install, update y uninstall son mutantes; no se ejecutaron.
6. DeepSeek Harness / DSH web profile
/home/lab/.dsh/profiles/web/package.json existe (1361 bytes), con nombre dsh-profile-web. No declara scripts, packageManager ni devDependencies; las dependencias reales están fijadas por el lockfile pnpm /home/lab/.dsh/profiles/web/pnpm-lock.yaml (lockfileVersion: '9.0', autoInstallPeers: false). Entre las versiones/specs observadas están dsh-hooks-plugin@0.2.15, dsh-opencode-provider@0.1.0, dsh-plugin@1.4.4, dsh-context@0.53.3, además de paquetes fijados a tarballs GitHub por commit (dsh-mcp-ui, dsh-see-image, dsh-single-terminal, sidebar y token-usage). No se imprimieron valores potencialmente sensibles.
La primera shell no cargaba NVM y por eso no encontraba Node. La verificación ampliada sí encontró NVM 0.40.3, Node 24.21.0, pnpm 12.4.2 y DSH 0.1.5-rc.2. Están bajo /home/lab/.nvm/versions/node/v24.21.0/bin. dsh --help respondió y documenta dsh --profile web o dsh web. La ausencia en el PATH de una conexión SSH no equivalía a que no estuvieran instalados.
En una máquina nueva, recupera esas versiones (no se reinstalaron en el host activo). Descarga e inspecciona primero el instalador de NVM:
mkdir -p /home/lab/installers
curl -fL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh -o /home/lab/installers/nvm-install.sh
less /home/lab/installers/nvm-install.sh
bash /home/lab/installers/nvm-install.sh
source /home/lab/.nvm/nvm.sh
nvm install 24.21.0
nvm use 24.21.0
npm install -g pnpm@12.4.2 @deepseek-ai/dsh@0.1.5-rc.2 \
@opencode/cli@2.0.5 @openai/codex@0.154.0
node --version
pnpm --version
dsh --version
dsh --help
La documentación NVM explica que se carga por shell. En una conexión no interactiva, carga nvm.sh o exporta el PATH versionado antes de diagnosticar paquetes inexistentes. No uses sudo npm con este NVM del usuario.
Instalación reproducible en una máquina nueva (no ejecutada en ia-lab):
mkdir -p /home/lab/.dsh/profiles/web
# Sólo en un perfil nuevo; no reemplazar un perfil con configuración propia.
test ! -e /home/lab/.dsh/profiles/web/package.json
cp /RUTA/AL/KIT/evidence/terminal/dsh-package.json /home/lab/.dsh/profiles/web/package.json
cp /RUTA/AL/KIT/evidence/terminal/dsh-pnpm-lock.yaml /home/lab/.dsh/profiles/web/pnpm-lock.yaml
cd /home/lab/.dsh/profiles/web
python3 - <<'PY'
import json
p = json.load(open("package.json"))
print(p["name"], sorted(p.get("dependencies", {})))
PY
pnpm install --frozen-lockfile
pnpm list --depth 0
dsh --profile web --help
# Arranque de la réplica; comprueba primero que su puerto esté libre:
dsh --profile web
Primero instala una versión de Node/pnpm compatible con la distribución DSH que se vaya a usar y conserva ambos archivos (package.json y pnpm-lock.yaml). --frozen-lockfile evita resolver versiones nuevas. Si pnpm informa scripts nativos bloqueados (por ejemplo node-pty), revisar el diff y ejecutar la aprobación de builds sólo de forma explícita; no convertir pnpm approve-builds en un paso automático. La presencia de un paquete en el lockfile no prueba que su binario nativo haya compilado.
7. OpenCode: configuración real frente a la documentación
/home/lab/bench/ornith/opencode-lab/env.sh apunta a un perfil aislado:
OPENCODE_CONFIG=/home/lab/bench/ornith/opencode-lab/config/opencode.json
OPENCODE_CONFIG_DIR=/home/lab/bench/ornith/opencode-lab/opencode.d
XDG_CONFIG_HOME=/home/lab/bench/ornith/opencode-lab/xdg-config
XDG_DATA_HOME=/home/lab/bench/ornith/opencode-lab/xdg-data
XDG_CACHE_HOME=/home/lab/bench/ornith/opencode-lab/xdg-cache
workspace=/home/lab/bench/ornith/opencode-lab/workspace
El JSON tiene $schema=https://opencode.ai/config.json, modelo local-ornith/ornith-local y provider local-ornith con:
name: Ornith 1.5 Local / llama.cpp
package: @opencode/ai/providers/openai-compatible
settings keys: apiKey, baseURL (valores no impresos)
model key: ornith-local
Hay una divergencia entre ejemplos/documentación disponibles y la CLI instalada; la configuración que realmente funciona en este perfil usa providers, package y settings. En una máquina nueva, confirma primero la versión de OpenCode y su esquema local; no mezcles fragmentos de versiones distintas.
Auditoría no destructiva del perfil:
cd /home/lab/bench/ornith/opencode-lab
source ./env.sh
opencode --version
python3 - <<'PY'
import json
p='/home/lab/bench/ornith/opencode-lab/config/opencode.json'; d=json.load(open(p))
print(d.get('$schema'), d.get('model'), list(d.get('providers', {})))
PY
La última línea evita imprimir secretos; no registres el entorno completo. El perfil local recuperado sí fue probado mediante un canario aislado y respondió correctamente; detalles en Agentes y MCP. Las credenciales personales de otros proveedores no forman parte del kit.
8. vLLM/SGLang y lo que realmente existe
Estado observado:
/home/lab/venvs/vllm Python 3.12.3, vLLM 0.29.0, torch 2.13.0+cu130
/home/lab/venvs/sglang Python 3.12.3, SGLang 0.5.19
Los binarios existen en /home/lab/venvs/vllm/bin/vllm y /home/lab/venvs/sglang/bin/sglang. El script histórico /home/lab/bench/ornith/vllm/setup.sh y su copia modular/vllm/baseline/setup.sh documentan sólo:
/home/lab/venvs/vllm/bin/pip install vllm-bnb-plugin==0.0.3
/home/lab/venvs/vllm/bin/pip check
# sanity: import torch, vllm, bitsandbytes y contar GPUs
El log correspondiente registra vLLM 0.29.0, torch 2.13.0+cu130, bitsandbytes 0.50.2 y una RTX 3090 visible. Sigue la instalación de la réplica en el manual principal, manteniendo intacto el entorno activo.
Fuentes oficiales actuales: instalación GPU de vLLM y instalación SGLang. Ambas cambian con CUDA/Python; para una máquina nueva fijar versión, GPU, driver y wheel antes de instalar. La guía actual de SGLang menciona CUDA 13 y que 0.5.19 fue la última rama CUDA 12; esto hace que el venv observado sea especialmente importante de preservar.
9. llama.cpp / FAALL
/opt/llama.cpp existe y su commit es exactamente:
82490b9d43954a82d659890a2d6c74dd68cf5653
Binaries observados:
/opt/llama.cpp/build/bin/{llama-cli,llama-server,llama-bench}
/opt/llama.cpp/build-faall-native/bin/{llama-cli,llama-server,llama-bench}
El historial APT está disponible en /var/log/apt/history.log. La instalación observada registra cuda-toolkit-13-0, libnccl2=2.28.9-1+cuda13.0 y libnccl-dev=2.28.9-1+cuda13.0; el inventario recuperado del operador también registra nvidia-driver-580. Son prerrequisitos del host auditado, no una receta universal: validar driver, GPU y repositorio antes de repetirlos. No apareció llama-cuda-faall.Dockerfile en /home/lab, /opt/llama.cpp ni /tmp. Sí existen:
/home/lab/bench/ornith/bench-faall-matrix.sh
/home/lab/bench/ornith/bench-faall-phase1b.sh
/home/lab/bench/ornith/LAST_FAALL_BUILD
El marcador contiene faall-build-20260917T145112Z. Los scripts refieren a la imagen lomelidev/llama.cpp:cu130-nccl-sse-faall-10974, usan Docker, GGML_CUDA_GRAPH_OPT=1 y crean salidas bajo $HOME/bench/ornith/...; no se iniciaron ni se inspeccionaron logs de contenedor.
La documentación oficial de instalación de llama.cpp ofrece binario, Docker y build desde fuente: llama.app Installation. Para este host no sustituye el build verificado: el commit y los binarios locales deben permanecer intactos hasta que exista una comparación funcional.
10. Receta reinstalable de máquina nueva (plan, no ejecutado)
- Instalar/validar SSH y entrar con la clave del operador; comprobar hostname, usuario y GPU.
- Instalar Herdr desde su fuente oficial, fijando release; validar
herdr --version. El servidor debe arrancar como servicio de usuario y el cliente debe conservar un workspace; usarherdr status server,herdr session listyherdr session attach <nombre>. - Instalar
moshi-hookdesde la guía oficial, instalar el servicio de usuario y comprobarmoshi-hook service status,moshi-hook statusymoshi-hook probe. El pairing requiere un valor privado: usarmoshi-hook pair --token <MOSHI_PAIRING_TOKEN>sólo con el token entregado fuera de documentación; nunca escribir el token real en este manual, historial compartido o captura de panel. - Crear sesiones tmux vacías y separadas con
terminales-examples/recreate-tmux-sessions.shdentro del kit. Usareplica-llama,replica-harness,replica-sglangyreplica-vllm; no reutiliza ni cierrallama. El ejemplo crea ventanas, pero no arranca servidores, descarga pesos ni ejecuta benchmarks. - Si se desea el teclado histórico, usar el fragmento mínimo
tmux-minimal.conf.exampleconprefix C-a; probarCtrl-A dy confirmar que el proceso sigue vivo. Guardar el/home/lab/.tmux.confhistórico como referencia y no reemplazarlo automáticamente. - Crear venv separados para SGLang/vLLM, fijar CUDA/Python y ejecutar
pip check/import smoke test antes de descargar pesos. Repetir únicamente paquetes compatibles con la GPU y el driver; el host auditado conserva versiones concretas, no una garantía portable. - Instalar el perfil DSH con
pnpm install --frozen-lockfiledesde supackage.json/pnpm-lock.yaml; revisar builds nativos bloqueados antes de aprobarlos. No asumir que una lista de dependencias equivale a una UI o hook operativo. - Compilar o recuperar llama.cpp en
/opt/llama.cppcon commit explícito; registrar hash de binarios y GPU backend. El historial CUDA/NCCL del host sirve como evidencia de prerequisitos, no como comando universal. - Configurar OpenCode con
OPENCODE_CONFIGyOPENCODE_CONFIG_DIRabsolutos; mantener las claves reales fuera del manual. El endpoint local sin autenticación está documentado en el perfil de ejemplo. - Sólo después hacer pruebas de endpoint, streaming y tool calling con un modelo pequeño; luego Ornith con la matriz de calidad/VRAM/contexto. Un proceso activo o un panel visible no prueba la ruta completa.
Crear sesiones vacías sin lanzar workloads
El script de ejemplo funciona en modo simulación por defecto (DRY_RUN=1). Para crear sólo sesiones tmux vacías, sin ejecutar modelos ni scripts de servicio, revisar su salida y usar DRY_RUN=0. Omite una sesión que ya existe para no modificar la referencia histórica:
DRY_RUN=1 bash terminales-examples/recreate-tmux-sessions.sh
# tras revisar la salida:
DRY_RUN=0 bash terminales-examples/recreate-tmux-sessions.sh
tmux list-sessions
tmux list-windows -a -F '#{session_name}:#{window_name}'
El layout histórico observó ventanas General, Log, Check, Test, Monitor, OpenCode y Codex en las sesiones principales, con varios panes en algunas ventanas. Los nombres no prueban el comando que corría dentro de cada pane; el ejemplo crea una ventana vacía por nombre y deja cualquier layout de panes para una decisión posterior.
Criterio de “instalado”
which/--version sólo prueba un binario. Para declarar una integración operativa hay que probar, en orden: proceso, socket/gateway, attach/detach, evento de hook, endpoint OpenAI-compatible, streaming y una tarea mínima. Separar cada fallo y conservar el estado existente.