Configuration
Répertoires de données, config.json v2, .spirit/, et variables d'environnement.
Spirit conserve les binaires et les données à des endroits différents. Les mélanger est la raison habituelle pour laquelle « J'ai installé la CLI mais les paramètres sont vides ».
Répertoire de données
Remplacez avec SPIRIT_AGENT_DATA_DIR. Le serveur peut aussi utiliser SPIRIT_SERVER_DATA_DIR (prioritaire sur le premier).
| OS | Valeur par défaut |
|---|---|
| macOS | ~/Library/Application Support/SpiritAgent |
| Windows | %APPDATA%\SpiritAgent |
| Linux | $XDG_DATA_HOME/SpiritAgent ou ~/.local/share/SpiritAgent |
| Repli | ~/.spirit-agent |
Fichiers typiques :
{spiritDataDir}/
config.json
mcp.json
hooks.json
rule.md
skills/
chats/
plans/
extensions/
automations/
dreams/
server.token
server/instances/Les binaires CLI se trouvent dans SPIRIT_HOME (~/.spirit ou %LOCALAPPDATA%\Spirit). Ce n'est pas ce répertoire. Voir Installer la CLI.
config.json v2
schemaVersion doit être 2. La version 1 est rejetée — supprimez l'ancien fichier et reconnectez un fournisseur.
Champs principaux :
providerGroups— maisons connectées, base API, transport, modèlesactiveModelimageGenerationModel/videoGenerationModel/lightweightChatModel
Les clés ne sont pas dans ce fichier. Elles vivent dans le trousseau.
Espace de travail .spirit/
| Chemin | Rôle |
|---|---|
.spirit/rule.md | Règle d'espace de travail règle |
.spirit/skills/ | Compétences d'espace de travail compétences |
.spirit/mcp.json | MCP d'espace de travail MCP |
.spirit/hooks.json | Hooks d'espace de travail hooks |
Également utilisés : {workspace}/AGENTS.md, {workspace}/.agents/skills/, {workspace}/plans/.
Variables d'environnement
| Variable | Rôle |
|---|---|
SPIRIT_AGENT_DATA_DIR | Répertoire de données |
SPIRIT_SERVER_DATA_DIR | Répertoire de données du serveur (prioritaire) |
SPIRIT_ACP_DATA_DIR / SPIRIT_ACP_WORKSPACE | ACP |
SPIRIT_HOME / SPIRIT_VERSION / SPIRIT_DOWNLOAD_HOST | Programme d'installation CLI |
SPIRIT_API_KEY / SPIRIT_API_BASE | Remplacements de processus CLI |
SPIRIT_WEB_HOST / SPIRIT_WEB_PORT / SPIRIT_DESKTOP_WEB_HOST | Hôte Web du Bureau |
SPIRIT_TERMINAL_SHELL | Shell PTY du Bureau |