TAO CODING user guide

Everything the README summarises, in detail: workspaces and panes, running several agents at once, worktree isolation, the web preview, the Meeting Room, settings, keyboard shortcuts, troubleshooting and current limits.

• Create a workspaceClick New workspace (the empty screen s button, the navbar, or the + at the end of the tab strip) to open the composer, a popup that fits without…
• PanesSplit from the pane header, drag the separator to resize, and drag a header onto another pane to swap the two — shells keep running. However narrow a pane…
• Running several agents at onceActivity icons — a grey spinner while a pane produces output, so you can see who is working; agent panes get the richer agent state icons instead (every…
• Agent state iconsAn agent pane shows its state as an icon — in the sidebar tree, right after the pane s title, on inactive workspace tabs and in the Meeting Room: a yellow…
• NotificationsA background agent pane chimes when it blocks (needs your input) or finishes — a short WebAudio tone, so you don t have to keep watching the icons. The…
• Resume past agent sessionsPicking a working folder also lists that folder s recent Claude Code, Codex, OpenCode and Qwen Code sessions under History session in the composer, read…
• Restore on launchQuit TAO CODING (tray → Quit, a crash or a reboot) and the next launch reopens every workspace as you left it: names, folders, how the panes are split…
• Worktree isolationWith the composer toggle on, every agent pane is created inside its own worktree at repo .worktrees/ name on a fresh tao/ agent - n branch — separate…
• The Git panelThe right panel is open from the first launch (the title-bar button hides and shows it). Its tabs (Preview, Git, Meeting Room, Files, Mobile…
• The Files tabThe Files tab in the right panel browses the focused pane s folder — the pane s worktree when it has one, otherwise the workspace folder. Click a folder…
• Web previewThe Website tab (globe icon) is a browser column docked beside the terminals, with a real address bar and working back/forward/reload. Each terminal keeps…
• The Mobile tabThe Mobile tab mirrors a connected Android device inside the panel, so the app your agents are building stays on screen while they edit it. It works with…
• The Architecture tabThe Architecture tab in the right panel shows a diagram of the project the focused pane is in, drawn with archify. Click any box to see a short…
• The Database tabA small TablePlus-style database client in the right panel (cylinder icon), for PostgreSQL, MySQL/MariaDB and SQLite. Connections belong to a project …
• Meeting RoomThe Meeting Room is a tab in the right panel (people icon). Drag a pane by its header onto the right panel and the agent joins the room, receiving a short…
• Status line in Claude Code panesEvery Claude Code pane gets a one-line readout under its prompt: mcp ✓ · ctx 84k/200k 42% The left half tells you whether Claude actually connected to TAO…
• Usage quota chipsNext to the ctx chip, Claude Code and Codex panes show how much of your plan you have spent — 5h 38%, 7d 71% — with the same amber-past-70 %, red-past-90…
• Terminal essentialsReal PTYs with 24-bit truecolor — agent CLIs, emoji and box drawing render exactly as in your normal terminal, and IMEs (Vietnamese Telex, CJK) work…
• Shell integrationA plain Terminal pane has no agent, so TAO CODING cannot tell when a command you typed has finished — unless your shell says so. If it emits the standard…
• Settings, tray and quittingSettings (the navbar gear, or ⌘/Ctrl + ,) is grouped into App (General, Appearance, Terminal), Development (Web Preview, Mobile, Editor), Agents (Agents…
• UpdatesTAO CODING quietly checks GitHub Releases for a newer version shortly after launch, then every few hours while it stays open. When one exists, an Update…
• Your accountTAO CODING asks you to sign in the first time you open it — with Google, GitHub, or an email and password. Sign in opens a page in your normal browser…
• TelemetryOfficial release builds send an anonymous usage ping so we can see how many people actually run TAO CODING: one app_open event at launch, then a heartbeat…
• What your agents can doEvery pane is automatically connected to the app over MCP for exactly as long as it lives — nothing to configure for Claude Code, Codex and Qwen Code…
• Keyboard shortcutsShortcut Action ⌘/Ctrl + B Show or hide the sidebar ⌘/Ctrl + Shift + B Toggle broadcast input Alt + Click Add or remove a pane from the broadcast group…
• TroubleshootingAn agent is greyed out in the composer — its CLI isn t on your PATH; install it and reopen the composer. A Meeting Room message never arrived — look for…
• Known limitsDatabase tab — no SSH tunnels or client certificates yet; Redis/MongoDB are not supported; table structure is edited with SQL, not a form. Restore is…