# Settings file locations

> Where Cartographer stores its settings, secure settings, and other configuration files on disk, for power users who want to edit or back them up directly.

For power users who want to edit settings directly or back up configurations.

## Main settings file

The following table lists the main settings file location for each supported platform.

| Platform | Path |
|----------|------|
| **macOS** | `~/Library/Application Support/UiPath Assistant/settings_v2.json` |
| **Windows** | `%APPDATA%\UiPath Assistant\settings_v2.json` |

- **In this file:** appearance, keyboard shortcuts, MCP servers you added yourself, and other per-machine UI state such as zoom level.
- **Not in this file:** model, effort, execution mode and behavior preferences — these are stored online for your user and tenant.
- Plain JSON format; human-readable and editable
- Changes take effect immediately (the app watches for file changes)
- If the file contains invalid JSON, Cartographer resets all local settings to their defaults and overwrites the file.
- Back up the file before editing. For safe edits, quit UiPath Assistant completely first (from the menu bar on macOS, or the system tray on Windows).

## Secure settings file

The following table lists the secure settings file location for each supported platform.

| Platform | Path |
|----------|------|
| **macOS** | Same directory, `secure-settings.enc` (Keychain encryption) |
| **Windows** | Same directory, `secure-settings.enc` (Data Protection API (DPAPI) encryption) |

- Contains: tool categories and Approval mode (a local copy; they're also stored online for your user and tenant), and secret plugin configuration values
- Only modifiable through the Settings UI
- Encrypted, so it can't be read or edited as plain text. Sandboxed agent commands are blocked from it.

## Other files

The following table lists other files stored in the settings directory.

| File | Contents |
|------|----------|
| `WindowState.json` | Window position, size, and maximized state |
| `local-conversations.db` | Local conversation history (when using Local storage) |
| `LocalSkills/` | Installed skills and routines |