Inicio rápido

Tu primer resultado útil lleva cuatro pasos en la aplicación de escritorio: instálala, conecta un modelo, abre la carpeta con tus archivos y describe la tarea con tus palabras, por ejemplo "Prepara un informe con gráficos a partir de ventas.csv". No hace falta terminal y Alisio pregunta antes de cambiar algo. El resto de esta página cubre la línea de comandos, que es la vía avanzada.

Aplicación de escritorio

1. Instala Alisio Desktop para tu sistema (instalador de Windows, .dmg de macOS, AppImage o .deb de Linux); consulta Descargar e instalar. Los instaladores no están firmados, así que Windows SmartScreen y macOS Gatekeeper muestran un aviso la primera vez.
2. Abre Alisio, ve a Ajustes, luego a Modelos, añade un perfil para tu servicio de modelos (o un servidor de modelos en tu equipo) y activa un modelo.
3. Abre la carpeta en la que deseas trabajar y describe la tarea. Alisio pregunta antes de cambiar algo. Revisa el resultado, pide correcciones y guárdalo.
4. Opcionalmente, añade herramientas para tu trabajo: instala un complemento desde Ajustes → Complementos → Catálogo de complementos (consulta Instalar complementos por profesión), crea el tuyo con el creador de complementos o conecta un servicio desde el catálogo MCP.

Línea de comandos (avanzado)

Alisio incluye activado el complemento de proveedor compatible con OpenAI, pero no un modelo ni credenciales predeterminados. Inicia la TUI y ejecuta /connect: elige el proveedor, introduce tus ajustes y clave, y selecciona un modelo descubierto. La selección se aplica globalmente en inicios posteriores.

Ruta rápida (60 segundos)

1. alisio setup — escribe un .alisio/config.json de ejemplo, sin secretos.
2. Exporta la variable de la clave que indique ese archivo (paso 2 más abajo).
3. alisio doctor --config ./my-api.json — confirma runtime, herramientas y proveedor.
4. alisio --config ./my-api.json — abre la TUI y ejecuta /connect para elegir proveedor y modelo.

Cada paso se detalla a continuación; Interfaz de terminal cubre la TUI.

1. Crear un archivo de configuración

alisio setup escribe un .alisio/config.json de ejemplo en el directorio actual, sin secretos. También puedes escribir el archivo tú mismo en cualquier ubicación.

alisio setup

Endpoint compatible con OpenAI (my-api.json):

{
  "schemaVersion": 1,
  "provider": {
    "baseURL": "https://api.openai.com/v1",
    "apiKeyEnv": "OPENAI_API_KEY",
    "model": "YOUR_MODEL_ID",
    "apiMode": "chat",
    "auth": "bearer",
    "tokenParameter": "max_completion_tokens",
    "streamUsage": true
  }
}

DeepSeek (deepseek.json, tras instalar el complemento DeepSeek con alisio install npm:@alisio/plugin-deepseek):

{
  "schemaVersion": 1,
  "provider": {
    "baseURL": "https://api.deepseek.com/v1",
    "apiKeyEnv": "DEEPSEEK_API_KEY",
    "model": "deepseek-chat",
    "apiMode": "chat",
    "tokenParameter": "max_tokens",
    "streamUsage": true
  }
}

Un servidor local sin autenticación usa "auth": "none" y su propia baseURL, por ejemplo http://127.0.0.1:1234/v1. Todos los campos se describen en Configuración.

2. Proporcionar la clave de API mediante el entorno

Las claves se leen solo de la variable de entorno indicada en provider.apiKeyEnv (por defecto OPENAI_API_KEY). Nunca escribas claves en archivos de configuración.

export OPENAI_API_KEY='YOUR_KEY'

PowerShell:

$env:OPENAI_API_KEY = 'YOUR_KEY'

3. Comprobar la instalación

alisio doctor --config ./my-api.json

doctor muestra la versión, el runtime, la plataforma, el workspace, las rutas de Git y ripgrep, y la configuración del proveedor, incluido si la variable de la clave está definida. Si falta ripgrep, también imprime los comandos de instalación por plataforma (lo usan search_text/list_files). Nunca muestra la clave.

4. Ejecutar

# TUI interactiva: las herramientas de escritura/proceso/red se ofrecen y preguntan antes de cada llamada
alisio --config ./my-api.json

# Headless, read-only: las herramientas de escritura/proceso/red ni siquiera se ofrecen
alisio run "Explain this repository" --config ./my-api.json --read-only

# Headless con eventos JSONL versionados en stdout (los diagnósticos van a stderr)
alisio run "Review the code" --config ./my-api.json --json

# Omitir la pregunta y permitir ediciones (y procesos, si hace falta) directamente
alisio run "Implement the task in docs/task.md" --config ./my-api.json --allow-write

Las herramientas de escritura/proceso/red de la TUI preguntan siempre por defecto —permitir una vez, permitir durante la sesión o denegar— sin necesitar ningún flag. --allow-write/--allow-process/--allow-external omiten esa pregunta y permiten directamente; --read-only las desactiva por completo, sin ofrecerlas nunca al modelo. Los modos headless run/resume <id> "prompt"/--json no tienen a nadie a quien preguntar, así que ahí esos mismos flags significan que la herramienta simplemente no está disponible sin ellos. --allow-process (o una respuesta de "permitir" a la pregunta) da acceso a procesos arbitrarios con tus privilegios de usuario; no es un sandbox. Consulta Herramientas y permisos para la tabla de verdad completa.

5. Sesiones

Las sesiones se guardan en SQLite y pueden reanudarse.

alisio sessions list
alisio resume <id>                 # opens the TUI with that session
alisio resume <id> "Continue"      # headless turn in that session
alisio sessions recover <id> --acknowledge

Indicar --model al reanudar cambia la sesión a ese modelo para los turnos siguientes. sessions recover solo es necesario cuando una caída dejó una herramienta con resultado incierto; consulta Compactación de contexto.

6. Generar AGENTS.md

Ejecuta la plantilla integrada /init en la TUI, o en modo headless, para crear o actualizar el AGENTS.md raíz con instrucciones específicas del proyecto para agentes de programación:

alisio run "/init" --config ./my-api.json --allow-write

Consulta Plantillas de prompts.

Modelo de confianza de la configuración

Abrir un repositorio no debe redirigir tu clave de API a un endpoint elegido por ese repositorio. Por eso Alisio lee:

Origen	Cuándo
--config <path>	Siempre que se indique: un archivo de confianza explícita
<workspace>/.alisio/config.json	Con --trust-project, o tras confiar en él interactivamente (ve abajo)
~/.config/alisio/config.json (ALISIO_CONFIG_HOME o XDG_CONFIG_HOME)	En los demás casos

Confiar en un proyecto también carga sus complementos ejecutables desde .alisio/plugins (todos los privilegios del proceso), y sus agentes/skills/prompts desde .alisio/agents, .agents/agents, .alisio/skills y .alisio/prompts.

Confianza interactiva de una sola vez. Al iniciar la TUI (no en modo headless run/--json, que siguen exigiendo --trust-project/--config explícitamente — ahí no hay nadie a quien preguntar) en un directorio con alguno de esos recursos de proyecto, sin --trust-project/ --config, se pregunta una vez:

This directory has Alisio project configuration: /path/to/repo
Trusting it lets Alisio load that configuration for this and future runs — including a possibly
different provider endpoint or API key — plus its plugins, agents, skills and prompt templates.
Declining uses Alisio's own defaults instead; nothing here is read.
Trust this project's Alisio configuration? [y/N]

La decisión se recuerda por directorio (alisio trust list/alisio trust revoke <path> la inspeccionan o la deshacen) junto con un hash del contenido de .alisio/config.json, así que editar ese archivo —incluso después de haber confiado una vez— vuelve a preguntar en lugar de mantener en silencio la confianza anterior. Un directorio sin ningún recurso de proyecto nunca recibe la pregunta. --trust-project/--config siguen siendo confianza explícita de una sola ejecución, como antes, y nunca se escriben en este almacén.

Siguiente: Interfaz de terminal · Plantillas de prompts · Configuración.