메뉴
End-user control of mosaic topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane mosaic layout.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
mosaic package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design discipline, testability, and Swift 6 concurrency rules. Use before adding or meaningfully rewriting Swift files, Swift packages, coordinators, services, repositories, or public package APIs.
Backend TypeScript and Cloud VM development rules for mosaic. Use when editing web/app/api, web/services, backend scripts, Cloud VM lifecycle, provider integrations, Postgres, Stack Auth pricing gates, migrations, or provider image build scripts.
End-user browser automation with mosaic. Use when you need to open sites, interact with pages, wait for state changes, and extract data from mosaic browser surfaces.
Build a custom mosaic sidebar from a plain-language request. Use when the user asks for a custom sidebar, a sidebar that shows their workspaces/tabs/PRs/clock, a vibe-coded sidebar, or anything involving files in ~/.config/mosaic/sidebars/. Covers authoring the interpreted SwiftUI-style file, enabling the beta flag, selecting it, and iterating with hot reload.
Customize mosaic for an end user. Use when changing mosaic.json actions, custom commands, workspace layouts, plus-button behavior, surface tab bar buttons, Command Palette entries, Dock controls, sidebar and app settings, shortcuts, notifications, browser routing, examples-library presets, or Ghostty-backed terminal preferences.
Debug logging, Debug menu, runtime pitfalls, typing-latency-sensitive paths, SwiftUI list snapshot boundaries, OS-version repros, and local visual iteration for mosaic. Use when adding debug probes, diagnosing UI/runtime issues, touching terminal rendering, tab/sidebar list views, drag/drop UTTypes, or using the Debug menu.
| name | mosaic |
| description | End-user control of mosaic topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane mosaic layout. |
Use this skill to control non-browser mosaic topology and routing.
# identify current caller context
mosaic identify --json
# list topology
mosaic list-windows
mosaic list-workspaces
mosaic list-panes
mosaic list-pane-surfaces --pane pane:1
# create/focus/move
mosaic new-workspace
mosaic new-split right --panel pane:1
mosaic move-surface --surface surface:7 --pane pane:2 --focus true
mosaic split-off --surface surface:7 right
mosaic reorder-surface --surface surface:7 --before surface:3
# attention cue
mosaic trigger-flash --surface surface:7
Use mosaic docs settings before changing mosaic-owned settings. It prints the docs URL, schema URL, raw GitHub resources, mosaic.json paths, and reload command.
mosaic docs settings
mosaic settings path
mosaic-owned settings live in ~/.config/mosaic/mosaic.json. Legacy ~/.config/mosaic/settings.json and ~/Library/Application Support/mosaic.com.emergent.app/settings.json files are read only as fallback for missing keys. Before editing, copy any existing mosaic.json file to a timestamped .bak next to it so the user can revert. Edit the user file, then reload:
mosaic reload-config
mosaic reload-config reloads BOTH mosaic.json and Ghostty config (~/.config/ghostty/config) and refreshes terminals in place. No app restart needed.
Use mosaic settings for app behavior, sidebar, notifications, browser behavior, automation, workspace colors, and mosaic-owned shortcuts. Terminal rendering settings such as font, cursor style, theme, scrollback, background transparency (background-opacity), and blur (background-blur) belong in Ghostty config at ~/.config/ghostty/config.
Open the UI when useful:
mosaic settings
mosaic settings mosaic-json
mosaic settings shortcuts
window:N, workspace:N, pane:N, surface:N.--id-format uuids|both.| Reference | When to Use |
|---|---|
| references/handles-and-identify.md | Handle syntax, self-identify, caller targeting |
| references/windows-workspaces.md | Window/workspace lifecycle and reorder/move |
| references/panes-surfaces.md | Splits, surfaces, move/reorder, focus routing |
| references/trigger-flash-and-health.md | Flash cue and surface health checks |
| ../mosaic-workspace/SKILL.md | Current caller workspace rules and non-disruptive automation |
| ../mosaic-settings/SKILL.md | Safe mosaic.json settings edits and validation |
| ../mosaic-browser/SKILL.md | Browser automation on surface-backed webviews |
| ../mosaic-markdown/SKILL.md | Markdown viewer panel with live file watching |