# Personal Space Settings: The Complete Guide

Personal Space (input bar `+` menu → "Personal Settings") has 12 tabs in total (admins get 1 more). This chapter explains **every page and every item** — what each setting does, its default value, and when to use it. Anything that can't be explained in one sentence on the settings page is covered in full here.

> Convention: "default" refers to the default value baked into the code. If you've used the `setup.sh` wizard, some defaults may have been overridden by your choices in the wizard.

---

## 1. General

| Setting | Default | Description |
|--------|------|------|
| Auto-generate title | On | Automatically generates a conversation title after the first round. When off, new conversations keep the "New Conversation" placeholder name and need manual renaming |

## 2. Personalization

This page decides "what personality the AI adopts when interacting with you".

| Setting | Default | What It Does & When to Use |
|--------|------|------------|
| Enable personalization | Off | Master switch for this page. When off, none of the settings below are injected into prompts |
| AI's self-name | Empty | What the AI calls itself (≤20 characters), e.g. "Xiao A" |
| How it addresses you | Empty | What the AI calls you (≤20 characters) |
| Occupation | Empty | Your occupation (≤20 characters). When filled in, the AI adjusts the depth of its explanations to your background — developers get technical details, business folks get plain language |
| Tone | Empty | 8 presets: conversational / humorous / blunt / encouraging / poetic / corporate / unconventional / empathetic |
| Notes | Empty | **The most powerful item**: up to 10 long-term instructions, each up to 2000 characters, injected into every round of conversation. Good for persistent preferences like "always answer in Chinese", "write code comments in English", or "I'm colorblind — avoid red-green palettes in charts" |
| Communication style | Standard | Standard AI style / human-like chat style / auto (switches by scenario) |
| Conversation continuity | Medium | High: actively revisits past conversations and memories; medium: balanced; low: each round stands on its own as much as possible. **If you've turned on "Recent conversation hints" but feel the AI keeps bringing up old topics irrelevantly, lower this setting** |

## 3. Model & Thinking

| Setting | Default | Description |
|--------|------|------|
| Default model | First visible item in the model library | The model used by default for new conversations; any registered model in the library can be chosen |
| Default thinking mode | Thinking | fast / thinking. Thinking mode gives higher quality; Fast mode responds faster |
| Default reasoning effort | Default (no parameter passed) | default / low / medium / high; only takes effect if the model supports `reasoning_effort` |

> The "defaults" here only affect **new conversations**; for existing conversations, adjust individually with the switcher in the input bar.

## 4. Appearance & Display

| Setting | Default | Description |
|--------|------|------|
| Theme | Classic | Classic (warm cream + warm orange) / Bright (cool white + near black) / Night (neutral grays) |
| Message flow display mode | Minimal mode | Traditional list / stacked animation / minimal mode; minimal mode has an extra "limit max height when expanded" toggle (on by default) |
| Condensed message display | Full info | Full original content / one-line summary |
| Hide stacked block dividers | Off | Hides the dividers between stacked blocks for a cleaner look |
| Show assistant status avatar | On | The status avatar in the conversation area (poke it — there's an easter egg) |
| Show Git status bar | On | The Git status bar above the input bar |
| Show custom names | On | Displays the self-name/address name you configured in the UI |
| Enhanced tool display | On | Structured rendering of tool results; turning it off makes output closer to raw |
| Auto-open terminal panel | — | Automatically expands the live terminal panel for terminal tasks |
| Auto-expand Quick Dock | On | Auto-expands Quick Dock when it has content; when off, it can only be opened manually |
| Hide Quick Dock | Off | Disables Quick Dock entirely |
| Real-time edit summary | Off | On: shows an edit summary card as the AI edits; off: shows a consolidated summary after each round of work |
| Wrap file preview | Off | On: the preview panel wraps lines to fit the width; off: long lines scroll horizontally |
| Group sidebar by workspace | Off | Groups the conversation list by workspace/project; grouping mode supports pinning and sorting workspaces |
| New conversation button behavior | Navigate to blank page | route: navigate to a blank new-conversation page / blank: immediately create an empty conversation |

## 5. Workspace & Permissions

| Setting | Default | Description |
|--------|------|------|
| Default permission mode | Approval | The initial permission mode for new terminals; see "Core Concepts" for the behavior of all four levels |
| Default work mode | Plan | The initial work mode for new terminals: Plan / Ask / Execute |
| Hide workspace by default | Off | Collapses workspace info in the UI by default |
| Auto-inject AGENTS.md | Off | On: each round automatically carries the project-root AGENTS.md, so the AI always works with the project standards in mind. Recommended for long-running projects |
| Track modifications | On | Writes the net diff of changes to `.astrion/modify_history/` after each round. When off, nothing is written and no prompt is injected |
| Version control on by default for new conversations | On | Keep this on — it's your file safety net |
| Version control backup method | Shallow backup | Shallow: only backs up files edited by the AI; full: snapshots the entire workspace (use with care on large projects) |
| Goal review mode | Read-only conversation | How goal mode is reviewed: readonly — judges from the conversation only / active — allows the review agent to run read-only commands for evidence |
| Goal max rounds | Has a default | The cap on auto-continuing rounds in goal mode |
| Goal token ceiling | Disabled | Stops when cumulative input + output tokens reach the limit (1k–100M). Note this is a workspace-level approximate count |

## 6. Context

This page is key to long-conversation quality; **read Section 4 of "Input & Context" before changing anything**.

| Setting | Default | Description |
|--------|------|------|
| Recent conversation hints | Off | On: new conversations automatically receive summaries of the most recent N historical conversations |
| Number of recent conversations | 10 | The N in the item above; 1–30 |
| Project memory index limit | 20 entries | Max number of project memory index entries injected (≥5; can be set to unlimited) |
| Auto shallow compression | Off | ⚠️ **breaks the context cache** — see "Input & Context". Not recommended |
| Shallow compression trigger tokens | 80000 | When customizing, **at least 80% of the model's actual usable context** |
| Shallow compression: keep recent tool results | 15 | The most recent N tool results are not compressed |
| Shallow compression: keep post-user tools | 3 | Tools after the most recent N user inputs are not compressed |
| Shallow compression: max replacements per round | 10 | Max number of tool results replaced in a single compression |
| Shallow compression: tool call interval | 10 | Checks whether to trigger every N tool calls |
| Auto deep compression | On | Recommended to keep on |
| Deep compression trigger tokens | 150000 | Follows the same 80% rule |
| Deep compression output form | Generate file | file: writes the summary to a file for on-demand use (recommended) / inject: injects the full summary directly |

## 7. Tools & Skills

| Setting | Default | Description |
|--------|------|------|
| Silently disable tools | On | When a tool is disabled, no prompt is injected into the model — cleaner context |
| Hide tool approval panel | On | Under the auto_approval mode, doesn't auto-pop the approval panel to bother you; off: any approval request pops up immediately |
| Tool intent description | On | Shows a brief "what it intends to do" note on tool call cards; turning it off makes the message flow more compact |
| Skill suggestions | Off | Dynamically suggests possibly relevant Skills based on the current task |
| Strict guard: terminal | Off | On: the AI must read the terminal-guide guidelines before using terminal tools |
| Strict guard: sub agents | Off | On: must read sub-agent-guide before dispatching sub agents |
| Strict guard: foreground commands | Off | On: must read the guidelines before run_command in foreground mode |
| Strict guard: background commands | Off | On: must read the guidelines before run_command in background mode |
| Enabled Skills list | All | Choose which Skills can be used |
| Disabled tool categories | None | Disables tools by category (e.g. disabling the web-search category) |

The four "strict guards" are guardrails for beginners: they force the AI to read usage guidelines before touching high-risk tools, significantly reducing the misoperation rate; once you're experienced, turning them off saves tokens.

## 8. Files & Images

| Setting | Default | Description |
|--------|------|------|
| Image compression level | Original | Original / 1080p / 720p / 540p. For long conversations with many large images, consider lowering the level to save context |

## 9. Data Management

A read-only **usage statistics** page: cumulative input/output tokens, total number of conversations, user message count, and tool call count, with manual refresh. It answers questions like "how many tokens did I burn this month".

## 10. Speech Model

Download management for the on-device speech recognition model (SenseVoice int8): about 228MB, **runs locally on the phone only — no network required**, supports mixed Chinese-English speech and automatic punctuation. The page shows download status (not downloaded / downloading with percentage / downloaded / incomplete download), and supports re-download or deletion. This feature targets the Android client.

## 11. Sub Agents

The multi-agent **role editor**: role list, create role, edit role. See Section 2 of "Agent Capabilities" for role fields and format. The 5 preset roles serve as reference, and custom roles are ready to use as soon as you edit them.

## 12. Review Agents

A unified configuration page for the three review agents (auto-approval / goal review / workflow review), each configurable with:

| Field | Description |
|------|------|
| Model | An entry name from the sub agent model library; **leave empty = use `default_model` from the library** |
| Thinking mode | fast / thinking |
| Timeout | Max wait time for a single review |
| Max rounds | Cap on the review agent's own working rounds |
| Command timeout | Per-command timeout for verification commands run during a review |

Configuration advice: review tasks follow fixed patterns and are called frequently, so cheap, stable models are enough — no need for flagship ones.

## 13. Admin (Visible to Admins Only)

An admins-only page: user and policy management (the `admin/`-related interfaces). Regular users can't see this page.

---

## Appendix: How Settings Take Effect

- All settings are stored in `personalization.json` in the data directory, isolated per user;
- "Default XX" settings only affect newly created objects (new conversations/new terminals), never existing ones;
- Display-related settings (theme, display mode, etc.) take effect immediately;
- Settings that involve prompt injection (personalization, notes, AGENTS.md injection, etc.) take effect from the next round of conversation.