# Configuration

Morphy keeps everything under one folder in your home directory: **`~/.morphy`**. The CLI and
the desktop app share it.

| What | Location |
| --- | --- |
| Sessions (conversations) | `~/.morphy/sessions` |
| Settings | `~/.morphy/config/global.json` |
| Encrypted secrets vault | `~/.morphy/secrets/vault.v1` |
| Model cache | `~/.morphy/cache/models` |

You rarely need to edit files by hand — most settings are managed from the interface.

## Settings

Open the settings hub from the interface:

```
/settings
```

From here (or the desktop **Settings** screen) you manage providers, models, channels, MCP
tools, appearance/themes, and general behavior.

## Secrets vault

API keys and tokens are stored **encrypted** on your machine — never in plain text. The vault
is protected by a passphrase you choose.

```
/secrets unlock <passphrase>     # create on first use, unlock afterwards
/secrets status                  # is it unlocked?
/secrets lock                    # lock it again
/secrets rotate-passphrase <new> # change the passphrase
```

You'll be prompted to unlock the vault the first time you save a key in a session.

## External tools (MCP)

Morphy can use extra tools provided by **MCP servers** (for example a filesystem, web fetch,
GitHub, or database tool). Add them from the interface:

```
/mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /path/to/projects
/mcp list
/mcp enable filesystem
/mcp disable some-server
```

To pass a token to a server, use a vault‑backed value:

```
/mcp set-env-secret github GITHUB_PERSONAL_ACCESS_TOKEN ghp_your_token_here
```

## Skills

List skills currently available to the agent:

```
/skills
```

Invoke one directly by typing `/<skill-name>` in the input.

## Permission modes

Morphy guards risky actions according to a mode — `safe`, `normal`, `auto`, or `yolo`. Change
it with `/mode`, or start with `--mode <mode>`. See
[Permission modes](cli.md#permission-modes).

## Server mode (advanced)

You can run Morphy as a background service that apps connect to:

```bash
morphy --server                       # stdio (default)
morphy --server --transport ws        # WebSocket on 127.0.0.1:7777
```

This is what the desktop app and editor integrations use under the hood. Most people never
need to start it manually.