Warpai warpai DOCS
Home Download 1 中文

Configuration & Appearance

Warpai provides both a graphical Settings panel (Cmd + , on macOS, Ctrl + , on Windows) and a declarative settings.toml configuration file. All data resides strictly within your local user directory.


Configuration File Locations

  • macOS / Linux: ~/.config/warpai/settings.toml
  • Windows: %USERPROFILE%\.config\warpai\settings.toml

Warpai watches this file for changes. Edits made in settings.toml or via the GUI sync bidirectionally in real time without requiring an application restart (except interface language changes).


Settings: Agent Communication Toggle

To allow local agents to communicate over the embedded MCP bus:

  1. Open Settings > Features > Agent communication.
  2. Toggle the switch ON.
  3. Check the CLI agents installed on your system.
SHOT-20 (P2) Settings: Agent Communication Toggle

设置面板中的 Agent 通信配置页:展示 Master 开关开启状态,以及列出的 20+ 款主流 Agent 勾选清单(Claude, Codex, Gemini 等)。

建议尺寸: 1100x750 目标路径: docs/images/settings-agent-communication.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx

Theme Customization: Claude Warm Light & Ink Pure Dark

Warpai ships with two signature themes: the default Claude Warm Light (warm sepia paper tones, subtle borders, and readable syntax colors) and Ink Pure Dark (deep black backgrounds, vibrant syntax contrast, and muted panel accents).

SHOT-21 (P2) Claude Warm Light Theme Presentation

默认 Claude Warm Light 经典暖光浅色主题全景展示:呈现舒适优雅的暖调质感与高对比度语法配色。

建议尺寸: 1440x810 (16:9) 目标路径: docs/images/appearance-claude-warm-light.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx
SHOT-28 (P2) Ink Pure Dark Theme Presentation

Ink 纯黑经典暗色主题全景:展示 Warpai 切换至 Ink Pure Dark 主题下的深黑底色、高对比度霓虹/柔光语法高亮及暗调协同面板。

建议尺寸: 1440x810 (16:9) 目标路径: docs/images/appearance-ink-pure-dark.png 截图待补充 · 对应表格 docs/SCREENSHOT-INVENTORY.xlsx

Essential Keyboard Shortcuts

Action macOS Windows
New Tab Cmd + T Ctrl + T
Close Tab Cmd + W Ctrl + W
Split Vertically Cmd + D Ctrl + Shift + D
Split Horizontally Cmd + Shift + D Ctrl + Shift + E
Toggle Vertical Tabs Cmd + Shift + V Ctrl + Shift + V
Command Palette Cmd + P Ctrl + P
Search Command History Cmd + R Ctrl + R
Toggle Project Explorer Cmd + B Ctrl + B
Settings Cmd + , Ctrl + ,