man stratum

Instalación

Requisitos

• Node.js 22 o superior.
• Un backend que exponga una API OpenAI-compatible: un servidor local (Ollama, llama.cpp, vLLM), un proxy (LiteLLM) o un servicio alojado.

Con npm

npm install -g stratum-cli
stratum --version

Para probarlo sin instalar nada:

npx stratum-cli chat

Para actualizar, repite la instalación con stratum-cli@latest.

Desde el código fuente

git clone https://github.com/choruzo/CLI.git
cd CLI/stratum-cli
npm install
npm run build
npm link            # deja el comando `stratum` en el PATH

Configuración

1. Conectar un modelo

A un provider le bastan la URL base y la API key. El asistente pregunta por ambas:

stratum provider add

O en una sola línea, sin asistente:

stratum provider add ollama --base-url http://localhost:11434/v1 --api-key ollama --default
stratum provider add hosted --base-url https://api.example.com/v1 --api-key-env EXAMPLE_API_KEY

Con --api-key-env el fichero guarda ${EXAMPLE_API_KEY}, no el valor: la key se lee del entorno en cada arranque. --api-key la deja escrita en claro.

El modelo es opcional. Si no lo indicas, Stratum consulta GET /models: chat abre el selector al arrancar y recuerda la elección; run e init usan el único modelo expuesto y, si hay varios, se detienen y los listan para que elijas con --model.

stratum provider list                 # providers y conectividad
stratum provider models               # modelos que expone el provider activo
stratum provider models --set <id>    # fija el modelo por defecto
stratum provider use <alias>          # cambia el provider activo
stratum provider remove <alias>

2. Dónde vive la configuración

Un fichero mínimo escrito a mano:

{
  "provider": {
    "default": "local-ollama",
    "providers": {
      "local-ollama": {
        "type": "openai-compatible",
        "baseUrl": "http://localhost:11434/v1",
        "apiKey": "ollama",
        "model": "qwen3.5:9b"
      }
    }
  }
}

También se puede leer y escribir clave a clave:

stratum config get provider.default
stratum config set agents.maxConcurrency 2

3. Secciones del fichero

El ejemplo con todas las claves está en .stratumrc.json.example ↗.

Servidores MCP

Un servidor que declara package se instala una sola vez en ~/.stratum/mcp/ y arranca directo con Node, sin pasar por npx cada vez. Sus tools aparecen como mcp__<servidor>__<tool>.

{
  "mcp": {
    "servers": [
      { "name": "filesystem", "package": "@modelcontextprotocol/server-filesystem@2025.8.21", "args": ["/home/user/projects"] },
      { "name": "otro", "command": "npx", "args": ["-y", "some-mcp-server@latest"] }
    ]
  }
}

stratum mcp install     # instala los que declaran `package`
stratum mcp list        # servidores y tools disponibles

Hosts remotos (SSH)

Stratum lleva su propio cliente SSH y no usa el binario del sistema. El agente solo ve los alias; las credenciales nunca pasan por el modelo. Sin sección ssh, las tools remotas ni siquiera existen.

{
  "ssh": {
    "hosts": {
      "bastion":  { "host": "bastion.example.com", "user": "javi", "privateKey": "~/.ssh/id_ed25519" },
      "prod-web": { "host": "192.168.1.10", "user": "javi", "privateKey": "~/.ssh/id_ed25519",
                    "jumpHost": "bastion", "confirmAll": true }
    }
  }
}

stratum ssh list                    # inventario con conectividad en vivo
stratum ssh trust prod-web          # muestra el fingerprint y lo confía
stratum ssh trust prod-web --force  # tras reinstalar el host

La primera conexión enseña el fingerprint y pregunta; después se verifica en silencio. Si la clave del host cambia, la conexión se aborta siempre. Las contraseñas y passphrases se pasan como env:<VAR>.

Entornos

Las reglas por entorno solo afectan a lo que cambia algo: leer en producción nunca pregunta.

{
  "environments": {
    "prod":    { "match": ["ssh:prod-*"], "tier": "production", "requirePlan": true },
    "staging": { "match": ["ssh:stg-*"],  "tier": "staging" },
    "lab":     { "match": ["ssh:dev-*"],  "policy": "allow" }
  }
}

Uso

Primeros pasos

stratum init                # explora el proyecto y escribe STRATUM.md
stratum chat                # sesión interactiva
stratum run "Analiza ./src y resume la arquitectura"
stratum run --plan "Refactoriza el módulo de autenticación"

STRATUM.md es la memoria del proyecto: se carga en cada sesión. Hay otro global en ~/.stratum/STRATUM.md para lo que vale en todos tus proyectos.

Modos de trabajo

Opciones comunes de chat y run

Comandos dentro del chat

Escribe / para abrir la paleta, con autocompletado por Tab.

Atajos de teclado

Perfiles de agente y skills

Un perfil es un fichero markdown con frontmatter en .stratum/agents/<nombre>.md (proyecto) o ~/.stratum/agents/ (global): describe para qué sirve, qué tools puede usar y su prompt. Las skills son instrucciones de tarea en .stratum/skills/<nombre>/SKILL.md; el agente ve su índice y lee el cuerpo solo cuando lo necesita.

stratum agents list          # perfiles válidos e inválidos, con su origen

Sesiones, memoria y logs

stratum sessions list
stratum sessions resume <id>
stratum sessions prune --older 30d

stratum memory list
stratum memory search "por qué elegimos sqlite"
stratum memory forget <id>

stratum logs path            # para adjuntar a un bug report
stratum logs tail 100

Cada comando que ejecuta el agente, local o remoto, queda registrado en ~/.stratum/logs/exec-audit.jsonl.

Instalación

La app instalada es autónoma: no necesita Node ni Rust. Los instaladores están en las releases de GitHub con etiqueta desktop-v…; la actual es la 0.3.0 (pre-release).

Windows

• Ejecuta el .exe (o el .msi si lo despliegas con herramientas de empresa).
• Necesita WebView2, que ya viene con Windows 11 y con las versiones actuales de Windows 10.
• Si el instalador no está firmado, SmartScreen mostrará un aviso: «Más información» → «Ejecutar de todas formas».

Linux

# Debian / Ubuntu
sudo apt install ./Stratum_0.3.0_amd64.deb

# Cualquier distribución
chmod +x Stratum_0.3.0_amd64.AppImage
./Stratum_0.3.0_amd64.AppImage

Comprobar la descarga

Cada release incluye SHA256SUMS.txt:

# Linux
sha256sum -c SHA256SUMS.txt --ignore-missing

# Windows (PowerShell): compara el resultado con la línea del fichero
Get-FileHash .\Stratum_0.3.0_x64-setup.exe -Algorithm SHA256

Actualizaciones

Al arrancar, la app busca versiones nuevas en silencio y muestra un aviso con «Instalar y reiniciar» o «Más tarde». Nunca instala sin que lo pidas. Se puede desactivar en Ajustes → Sistema.

Desde el código fuente

Hacen falta Node 22 y Rust estable (en Windows, MSVC Build Tools; en Linux, las librerías de WebKitGTK).

git clone https://github.com/choruzo/CLI.git
cd CLI/stratum-cli && npm install
cd ../stratum-desktop && npm install
npm run sidecar:build     # empaqueta el núcleo; repítelo si cambia stratum-cli
npm run tauri dev         # ventana de desarrollo
npm run tauri build       # instaladores

Configuración

Primer arranque

Sin ningún modelo configurado, la app abre un asistente: URL del servidor, API key, nombre y modelo (los lista consultando /models). Al terminar, la conversación queda lista para escribir. Si eliges «Ahora no», un aviso con «Conectar un modelo» lo retoma más tarde.

Ajustes

Se abren con Ctrl+,, con /settings o con el icono ⚙.

Los cambios se aplican a cada conversación antes de su siguiente mensaje. La carpeta y los límites de los espacios de trabajo, y el logging, piden reiniciar el agente; la app lo ofrece.

Claves de desktop

{
  "desktop": {
    "maxConcurrentTurns": 2,
    "notifications": { "enabled": true, "minSeconds": 10 },
    "globalHotkey": "CommandOrControl+Shift+Space",
    "updates": { "autoCheck": true },
    "workspaces": {
      "root": "~/.stratum/desktop/workspaces",
      "maxFileMB": 25,
      "maxWorkspaceMB": 250,
      "compressAfterDays": 7,
      "deleteAfterDays": 30
    }
  }
}

Uso

Conversaciones

El panel lateral las agrupa por fecha. Se pueden buscar, renombrar, fijar y eliminar; el título se pone solo tras el primer mensaje. Varias conversaciones pueden trabajar a la vez: las que superan el límite quedan «en cola» y arrancan por orden.

Ficheros

• Adjuntar: con el botón o arrastrando al chat. Se copian a la carpeta inputs/ de la conversación.
• Resultados: lo que el asistente genera aparece en outputs/ como tarjetas con «Abrir», «Guardar como…» y vista previa.
• Descargar todo: un .zip con los ficheros de la conversación.
• El asistente solo puede leer y escribir dentro de esa carpeta. Por defecto, 25 MB por fichero y 250 MB por conversación.

Comandos

Atajos de teclado

Confirmaciones y avisos

• Antes de una operación que modifica ficheros de forma destructiva, el asistente pregunta. Sin respuesta en 5 minutos, se deniega.
• Si una respuesta tarda más de 10 segundos y la ventana no está a la vista, llega una notificación del sistema al terminar.
• El razonamiento del modelo se muestra plegado («Razonó 12 s») y se despliega al pulsarlo.

Dónde se guardan los datos