# Settings

## Output Style

Controls how Maxy communicates with you.

| Style | Behaviour |
|-------|-----------|
| `default` | Concise, direct responses — gets to the point |
| `explanatory` | More detailed responses with educational context — explains reasoning and trade-offs |

**Changing output style:** Tell Maxy "Switch to explanatory mode" or "Use default output style."

Changes take effect on the next session. The current session continues with the existing style.

## Effort Level

Controls how much work Maxy puts into each task — specifically, how many steps it takes before stopping and checking with you.

| Level | Max turns | Use when |
|-------|-----------|----------|
| `low` | 5 | Quick questions, simple lookups |
| `medium` | 10 | Standard tasks — most daily use |
| `high` | 20 | Complex multi-step tasks |
| `auto` | 20 | Let Maxy decide (same ceiling as high) |
| `max` | 40 | Long autonomous workflows |

**Changing effort level:** Tell Maxy "Set effort to high" or "Use low effort mode."

Changes take effect on the next session.

## Thinking View

Controls how Maxy's thinking process is displayed in the chat.

| Mode | Behaviour |
|------|-----------|
| `default` | Thinking steps shown expanded, tool use collapsed |
| `expanded` | Everything shown expanded — thinking, tool use, and results |
| `collapsed` | Everything collapsed — compact view, expand on tap |

**Changing thinking view:** Tell Maxy "Show thinking by default", "Show everything expanded", or "Hide thinking."

Changes take effect on the next session.

## Viewing Current Settings

Ask Maxy: "What are my current settings?" or "What output style am I using?"

## Context Mode

Controls how Maxy manages conversation history between messages.

| Mode | Behaviour |
|------|-----------|
| `claude-code` (default) | Maxy maintains a continuous session across messages. Conversation flows naturally — each message picks up where the last left off. When the session gets long, Maxy automatically summarises and starts fresh so it doesn't lose track. |
| `managed` | Each message starts a fresh session. Maxy keeps a rolling history of your conversation and injects it into each new session. Older messages are trimmed and saved to memory when the history gets too long. You'll see a usage indicator in the footer showing how much history is being carried. |

Both modes preserve your conversation context — they differ in how that context is stored and carried forward. Most users should keep the default (`claude-code`). Switch to `managed` if you notice Maxy losing context in long sessions or if you prefer the rolling-history approach.

**Changing context mode:** Tell Maxy "Switch to managed mode" or "Use claude-code mode." You can also click the context mode value in the info panel. Changes take effect on the next message.

## Default Agent

Controls which public agent serves the root URL (`/`). Visitors who go to your public site without specifying an agent slug see this agent.

**Changing the default agent:** Tell Maxy "Make sales the default agent" or "Set the default to support."

The change takes effect on the next page load. The previous default agent remains accessible at its `/{slug}` URL.

## Account Preferences

You can ask Maxy to show or change any of the following:

- Default agent (which public agent serves the root URL)
- Admin model (which Claude model powers the admin agent)
- Public model (which Claude model powers the public agent)
- Output style
- Effort level
- Context mode
- Enabled plugins

Tell Maxy what you want to change and it handles the rest.

## PIN

Your admin PIN is set during initial setup. To change it, ask Maxy: "Change my admin PIN."

Maxy will ask for your current PIN to verify, then set the new one.
