Reset Settings
Fully reset Jean by deleting the local config directory. Useful when authentication, preferences, or session state get into a bad state.
Jean stores all of its local state in a single config directory.
When something gets stuck — a stale auth loop, broken preferences, a corrupted UI state — the fastest fix is to quit Jean and delete that directory. The app rebuilds it on next launch.
What gets reset
Wiping the config directory clears:
- preferences and UI state
- the project list and session metadata
- recovery snapshots and pasted images
- bundled CLI installs that Jean manages (Claude, Codex, OpenCode, GitHub)
- webview cookies, cache, and local storage
It does not touch:
- your git repositories or worktrees on disk
- backend credentials stored outside the config dir (for example, the macOS Keychain entry
Claude Code-credentials) - anything installed system-wide, like a Homebrew
ghbinary
This is destructive
Deleting the config directory removes your project list and session history. If anything in there is worth keeping, copy preferences.json and projects.json somewhere safe before you continue.
Where settings live
Jean uses the Tauri app data directory for the identifier com.jean.desktop.
| Platform | Path |
|---|---|
| macOS | ~/Library/Application Support/com.jean.desktop/ |
| Linux | ~/.local/share/com.jean.desktop/ |
| Windows | %APPDATA%\com.jean.desktop\ |
Dev and nightly builds use com.jean.desktop.dev instead of com.jean.desktop.
Before you reset
- Quit Jean fully —
Cmd+Qon macOS, close from the tray on Windows and Linux. A running app will rewrite some files on exit. - Optional: back up
preferences.jsonandprojects.jsonfrom the config directory.
Reset the config directory
rm -rf ~/Library/Application\ Support/com.jean.desktopFor dev builds:
rm -rf ~/Library/Application\ Support/com.jean.desktop.devrm -rf ~/.local/share/com.jean.desktopFor dev builds:
rm -rf ~/.local/share/com.jean.desktop.devIf you have set $XDG_DATA_HOME, replace ~/.local/share with that path.
Remove-Item -Recurse -Force "$env:APPDATA\com.jean.desktop"For dev builds:
Remove-Item -Recurse -Force "$env:APPDATA\com.jean.desktop.dev"rmdir /s /q "%APPDATA%\com.jean.desktop"For dev builds:
rmdir /s /q "%APPDATA%\com.jean.desktop.dev"Reset just one piece
If only one part of the state is broken, delete a single file instead of the whole directory:
preferences.json— app preferences, defaults, keybindingsprojects.json— the project listui-state.json— window and panel statesessions/— session history and metadatarecovery/— crash-recovery snapshots
The path resolution is the same as above, just append the file or folder name.
Restart Jean
Launch Jean again. The app starts in first-run state and rebuilds the config directory. Re-add your projects and re-authenticate any backends you cleared.
If a problem comes back immediately after a reset, capture the steps and open an issue at coollabsio/jean/issues — that usually points to a bug rather than a stuck setting.