# 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](/operar-ia-lab/perfiles/) y [el índice de archivos del kit](/archivos/).

[TOC]

## 1. Entrada segura y límites

```sh
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/herdr` existe, ELF estático x86-64, `herdr 0.9.1`.
* `/home/lab/.config/systemd/user/herdr.service` ejecuta `/home/lab/.local/bin/herdr server`, `Restart=on-failure`; sus variables `Environment=` fueron redactadas.
* `systemctl --user is-enabled herdr.service` → `enabled`; `is-active` → `active`.
* `herdr status server` → `running`, versión `0.9.1`, endpoint/protocolo privado compatibles, socket `/home/lab/.config/herdr/herdr.sock`.
* `/home/lab/.config/herdr/config.toml` fija `keys.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](https://github.com/SuperCodeAgents/herdr-terminal) y [quick start](https://herdr.dev/docs/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:

```text
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:

```text
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:

```text
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 devuelve `moshi-hook version 0.3.26`.
* `/home/lab/.config/systemd/user/moshi-hook.service` está `enabled` y `active`.
* `moshi-hook status` → `paired`; host `ia-lab`; servidor Moshi Pro adjunto; socket `/run/user/1000/moshi-hook.sock`.
* `moshi-hook probe` → `installed: true`, `running: true`, `gateway: true`, versión `0.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](https://getmoshi.app/docs/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:

```sh
/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:

```sh
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](https://github.com/nvm-sh/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`):

```sh
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:

```text
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:

```text
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:

```sh
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](../../laboratorio/agentes/). Las credenciales personales de otros proveedores no forman parte del kit.

## 8. vLLM/SGLang y lo que realmente existe

Estado observado:

```text
/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:

```sh
/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](https://docs.vllm.ai/en/latest/getting_started/installation/gpu/) y [instalación SGLang](https://github.com/sgl-project/sglang/blob/main/docs/docs/get-started/install.mdx). 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:

```text
82490b9d43954a82d659890a2d6c74dd68cf5653
```

Binaries observados:

```text
/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:

```text
/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](https://llama.app/docs/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)

1. Instalar/validar SSH y entrar con la clave del operador; comprobar hostname, usuario y GPU.
2. 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; usar `herdr status server`, `herdr session list` y `herdr session attach <nombre>`.
3. Instalar `moshi-hook` desde [la guía oficial](https://getmoshi.app/docs/install-moshi-hook), instalar el servicio de usuario y comprobar `moshi-hook service status`, `moshi-hook status` y `moshi-hook probe`. El pairing requiere un valor privado: usar `moshi-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.
4. Crear sesiones tmux vacías y separadas con `terminales-examples/recreate-tmux-sessions.sh` dentro del [kit](../../downloads/ia-lab-replica-v4.7.zip). Usa `replica-llama`, `replica-harness`, `replica-sglang` y `replica-vllm`; no reutiliza ni cierra `llama`. El ejemplo crea ventanas, pero no arranca servidores, descarga pesos ni ejecuta benchmarks.
5. Si se desea el teclado histórico, usar el fragmento mínimo `tmux-minimal.conf.example` con `prefix C-a`; probar `Ctrl-A d` y confirmar que el proceso sigue vivo. Guardar el `/home/lab/.tmux.conf` histórico como referencia y no reemplazarlo automáticamente.
6. 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.
7. Instalar el perfil DSH con `pnpm install --frozen-lockfile` desde su `package.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.
8. Compilar o recuperar llama.cpp en `/opt/llama.cpp` con 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.
9. Configurar OpenCode con `OPENCODE_CONFIG` y `OPENCODE_CONFIG_DIR` absolutos; mantener las claves reales fuera del manual. El endpoint local sin autenticación está documentado en el perfil de ejemplo.
10. 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:

```sh
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.
