Referencia

Archivos y entorno

Dónde guarda Ferret sus propios archivos y qué variables de entorno lee o define.

#Carpeta userData

Los datos de la app están en la carpeta userData de Electron. Su nombre está fijado en ade-movie (no en el nombre del producto), así que los datos sobreviven a los cambios de nombre. Puedes cambiarla con --user-data-dir=<path>.

Sistema operativo	Ruta
macOS	`~/Library/Application Support/ade-movie/`
Windows	`%APPDATA%\ade-movie\`
Linux	`~/.config/ade-movie/` (o `$XDG_CONFIG_HOME/ade-movie/`)

settings.json       # settings before 0.1.1, kept as a backup (now ~/.ferret/settings.json)
stt-keys.bin        # API keys, encrypted with safeStorage
models/             # downloaded whisper models (ggml-*.bin)
accounts/claude/<id>/   # CLAUDE_CONFIG_DIR for added accounts
accounts/codex/<id>/    # CODEX_HOME for added accounts

Tus ajustes no están en esta carpeta: están en ~/.ferret/ (consulta Configurar con settings.json).

Un modelo que hayas elegido tú puede estar en cualquier sitio. La antigua ubicación predeterminada ~/.cache/ade-movie/models/ggml-small.bin se sigue comprobando.

#Variables de entorno

Variable	Efecto
`CLAUDE_CONFIG_DIR`, `CODEX_HOME`	Ferret las define para las pestañas de agente cuando hay seleccionada una cuenta añadida
`GH_TOKEN`, `GITHUB_TOKEN`	`gh` las usa antes que su propio inicio de sesión. Ferret avisa cuando alguna está definida
`FERRET_CONFIG_DIR` (o la antigua `MOVIE_ADE_CONFIG_DIR`)	Carpeta para `settings.json`, `state.json` y `settings.schema.json` en lugar de `~/.ferret`
Nombres en `apiKeyEnv`	Claves de API a las que apuntas desde `settings.json`. También se leen del `.env` del proyecto y de `~/.ferret/.env`
`ADE_PROJECT_DIR`	Abre (y registra) esta carpeta como proyecto al iniciar
`ADE_INITIAL_URL`	Carga esta URL en el navegador integrado al iniciar
`ADE_WHISPER_MODEL`	Ruta absoluta de un modelo GGML para la transcripción en el dispositivo, en lugar del predeterminado descargado
`FERRET_SENTRY_DSN` (o la antigua `MOVIE_ADE_SENTRY_DSN`)	Adónde van los informes de fallos. Vacía significa que no se envía ninguno (consulta Informes de fallos)
`OPENAI_API_KEY`	Se lee de `.env` solo en desarrollo (`pnpm dev`), nunca en las versiones empaquetadas
`PATH`	Se usa para encontrar los comandos de tus agentes (`claude`, `codex`, `gemini`…), `gh`, `git` y `whisper-cli`. En macOS y Linux se añaden las ubicaciones de Homebrew, linuxbrew y snap

#Dentro de tu proyecto

.ferret/reviews/<id>/: revisiones (consulta Datos y privacidad). Las revisiones antiguas en .ade-movie/reviews/ se siguen leyendo
.git/info/exclude: una línea, .ferret/, que se añade en la primera grabación

Ayuda a traducir esta página en GitHub (se abre en una pestaña nueva)