Config
Directorio de datos, config.json v2, .spirit/ y variables de entorno.
Spirit guarda los binarios y los datos en lugares diferentes. Mezclarlos es la razón habitual por la que «instalé la CLI pero la configuración está vacía».
Directorio de datos
Se puede sobrescribir con SPIRIT_AGENT_DATA_DIR. El servidor también puede usar SPIRIT_SERVER_DATA_DIR (que tiene prioridad sobre el anterior).
| SO | Default |
|---|---|
| macOS | ~/Library/Application Support/SpiritAgent |
| Windows | %APPDATA%\SpiritAgent |
| Linux | $XDG_DATA_HOME/SpiritAgent o ~/.local/share/SpiritAgent |
| Fallback | ~/.spirit-agent |
Archivos típicos:
{spiritDataDir}/
config.json
mcp.json
hooks.json
rule.md
skills/
chats/
plans/
extensions/
automations/
dreams/
server.token
server/instances/Los binarios de la CLI viven en SPIRIT_HOME (~/.spirit o %LOCALAPPDATA%\Spirit). Ese no es este directorio. Ver Instalar CLI.
config.json v2
schemaVersion debe ser 2. La versión 1 se rechaza: elimina el archivo antiguo y vuelve a conectar un proveedor.
Campos principales:
providerGroups— casas conectadas, base de API, transporte, modelosactiveModelimageGenerationModel/videoGenerationModel/lightweightChatModel
Las claves no están en este archivo. Viven en el keyring.
Espacio de trabajo .spirit/
| Ruta | Rol |
|---|---|
.spirit/rule.md | Regla del espacio de trabajo |
.spirit/skills/ | Habilidades del espacio de trabajo |
.spirit/mcp.json | MCP del espacio de trabajo |
.spirit/hooks.json | Hooks del espacio de trabajo |
También se usan: {workspace}/AGENTS.md, {workspace}/.agents/skills/, {workspace}/plans/.
Variables de entorno
| Variable | Rol |
|---|---|
SPIRIT_AGENT_DATA_DIR | Directorio de datos |
SPIRIT_SERVER_DATA_DIR | Directorio de datos del servidor (gana) |
SPIRIT_ACP_DATA_DIR / SPIRIT_ACP_WORKSPACE | ACP |
SPIRIT_HOME / SPIRIT_VERSION / SPIRIT_DOWNLOAD_HOST | Instalador de CLI |
SPIRIT_API_KEY / SPIRIT_API_BASE | Overrides de proceso CLI |
SPIRIT_WEB_HOST / SPIRIT_WEB_PORT / SPIRIT_DESKTOP_WEB_HOST | Host web de escritorio |
SPIRIT_TERMINAL_SHELL | Shell PTY de escritorio |