Command Center

The Command Center is the IDE-like workspace for each project. It brings together the chat interface, file browser, terminal, preview, and git tools in a single view.

Layout#

The Command Center uses a multi-panel layout:

Left Sidebar Tabs#

Files#

Tree view of the project workspace directory. Browse, open, and view files. The Files tab also embeds a Git status panel showing modified/staged files and diff access. See File Browser for details.

History#

List of past tasks for this project. Tasks are grouped by time (Today, Yesterday, etc.) or by plan when plan groups exist. Click any task to view its full conversation and tool calls.

Search#

Search across project files by text pattern. Results show the matching file path, line number, and a preview of the line. Click any result to open the file at that line in the right panel.

Services#

Manage provisioned services (PostgreSQL, Redis) for this project. View service status, credentials, and health. See Project Services.

Center Panel#

The task chat interface showing:

• Message stream — Real-time display of agent responses, tool calls, and diffs
• Status and cost — Queue position, visibility, and total token/USD cost for the active execution are shown in the toolbar above the chat

For an active task, the chat input at the bottom lets you send follow-up messages. To start a new task from scratch, click New in the History sidebar.

See Tasks for full details on the task lifecycle.

Right Panel#

The right panel is a tabbed editor. Multiple tabs can be open at once; tabs can be dragged to reorder, pinned by double-clicking, and closed individually or all at once via right-click context menu.

File View#

Click any file in the Files tab to view its contents in the right panel with syntax highlighting.

Diff View#

Opens a side-by-side diff for a file with uncommitted changes. Triggered from the Git panel in the Files tab.

Preview#

Live preview of the project running in a container. Start, stop, and share previews. See Preview.

Runs Tab#

Shows the individual agent runs (sub-steps) within the active task, including per-run status, token counts, and cost.

Activity Tab#

A read-only chronological log of task events: creation, ownership handoffs, autonomous decisions, and smoke test results. When the viewer has share-management permissions, a read-only "Shared with" list is also shown. Share and hand-off actions are toolbar buttons in the center panel, not controls inside this tab.

Comments Tab#

Inline comment threads attached to the active task. See Comments.

Service Catalog / Service Detail#

Add a new project service (PostgreSQL, Redis) via the service catalog, or view credentials and status for an existing one. See Project Services.

Bottom Panel#

The bottom panel has two top-level tabs:

• Terminal — One or more interactive terminal sessions connected to the project container. Up to four terminals can be open simultaneously; terminals can be split side by side. See Terminal.
• Logs — Contains two sub-tabs:
  • Server Logs — Streams stdout and stderr from the preview container in real-time via WebSocket. Useful for debugging build errors, watching server logs, and monitoring application output.
  • Console — Captures JavaScript console output (log, info, warn, error) from the preview iframe, with per-level filtering.

Keyboard Shortcuts#

Additional Features#

• Zen Mode — Press Z or use the header menu to hide the left, right, and bottom panels, leaving only the center chat view. Panel layout is restored on exit.
• Layout Swap — Swap the center (chat) and right (editor) panels so the editor is centered and the chat is on the right.
• Quick File Open — Press Ctrl/Cmd + P to open a fuzzy file finder without leaving the keyboard.
• Status Bar — A thin bar at the bottom of the workspace shows cursor position, file language, line count, current git branch (clickable to switch branches), and preview container status.

Agent Capabilities#

Semantic Code Search#

The agent has access to a SearchCode tool that performs natural-language semantic search across the indexed project codebase. Unlike text-pattern grep, it embeds the query and returns the top matching file paths, line ranges, and code snippets ranked by cosine similarity — useful for finding "where is X handled" or "show me code similar to Y."

The tool is available during both the planning and execution phases of a task and operates against a ChromaDB vector index built from the project files.

Real-Time Updates#

The Command Center maintains several WebSocket connections:

• Task WebSocket — Streams agent messages and status updates
• Project WebSocket — Watches for git status, file changes, execution list changes, and vector indexing progress
• Preview Logs WebSocket — Streams container output
• Presence WebSocket — Shows which team members are active in the workspace (presence is workspace-wide, not per-project)

A connection status banner indicates if the WebSocket connection is active.

Troubleshooting#

Left/right panels are hidden. The layout state is persisted per project. Use the toolbar buttons at the top of the page to re-open the Files, Preview, or Terminal panels, or press P to toggle the left sidebar.

Panels not visible on mobile. The left and right panels are collapsed on narrow screens. Use the mobile drawer (swipe or tap the history/files button) to access files and task history. The terminal and server logs are not available on mobile viewports.

WebSocket disconnected banner appears. The chat view shows a banner if the execution WebSocket drops. The connection reconnects automatically and performs a gap-fill: any messages missed while disconnected are fetched via GET /executions/{id}/messages?since_sequence={last} and merged into the view without requiring a page refresh.

Preview container shows "Stopped" in the status bar. The preview is not running. Click the container toggle in the header bar to start it, or open the Server Logs tab to check for build errors from the last run.