Workspace

The Problem

Developer tools tend to scatter context across windows. Your terminal is in one app, your task board in a browser tab, your notes in another, your docs somewhere else. When an AI agent creates a task or references a document, you have to manually find it. The workspace should be a single surface where everything lives together and stays in sync.

What's Built

The Hub

The Hub is Sidespace's home screen and the only permanent tab. It is a single scrollable dashboard organized into three sections:

Section	What It Shows
Projects	A card for each active project with stage, directory, and color-coded identity
Agents	Status cards for Hoshi, Umbra, and Kosmos
System	Cost tracking and operational health

A category filter at the top lets you narrow the view to just Projects, Agents, or System.

The left column of the Hub has three tabbed panels:

• Feed -- a reverse-chronological stream of activity (research digests, agent completions, system events). Think of it as a lightweight inbox.
• Todos -- a flat checklist pulled from all your notes and tasks. Drag to reorder.
• Notes -- quick access to your scratch pad (a dismissable tab you can open and close).

Two-Tier Tab System

Sidespace uses two levels of tabs:

1. Global tabs -- the Hub is always present. Other global views (like cost tracking) open as additional dismissable tabs.
2. Project tabs -- clicking "Open" on any project card opens a dedicated tab for that project. Each project tab has its own set of child views:

Child View	Purpose
Themes	High-level strategic groupings for features
Roadmap	Four-column board (Now / Next / Later / Done) for feature planning
Kanban	Task board with drag-and-drop status columns
Docs	Read-only index of documents found in the project's directory
Files	File browser for the linked project directory

You can have multiple project tabs open simultaneously and switch between them.

Project Sidebar

Every project tab includes a fixed 220px sidebar on the left. This is where you manage project metadata:

• Name and organization -- editable inline
• Description -- free-text project summary
• Stage -- lifecycle state (idea, planning, building, launched, maintenance, paused, archived)
• Directory -- link or unlink a local filesystem directory
• Archive -- soft-delete that preserves all data

The sidebar is always visible when you are inside a project tab, so core metadata is never more than a glance away.

Squad View

Squad View is a multi-agent observability cockpit where you can run, monitor, and coordinate multiple CLI agents simultaneously. It uses a three-zone layout: a task sidebar showing grouped tasks with status and agent assignments (~220px left), a focused terminal in the center, and a thumbnail strip at the bottom for switching between running agents.

Each agent gets a constellation name (Orion, Lyra, Vela) for identity across session logs and memories. Panels show running (green), idle (amber after 30s timeout), or ended (red with preserved scrollback) states. The system automatically detects and launches the appropriate CLI tool for each agent type, with environment variables injected to enable agent-aware behavior.

Right Panel

A collapsible panel on the right edge of the window provides access to Hoshi, the AI assistant. It is available from any view -- you do not need to navigate away from your current context to ask a question or trigger a tool call. The panel can also be popped out into a floating window that you can reposition and resize freely.

When Squad View is active, the right panel becomes Hoshi-only chat (no terminal tab) since Squad View serves as the dedicated terminal surface.

Keyboard Shortcuts

Shortcut	Action
Cmd+1	Go to Hub
Cmd+2-9	Switch to open project tabs by position
Cmd+K	Command palette
Cmd+Shift+K	Memory search
Cmd+W	Close current tab
Cmd+N	Create new task / Add terminal in Squad View
Cmd+Shift+N	Create new note
Cmd+Shift+S	Toggle Squad View
Cmd+,	Settings

In Squad View specifically:

• Cmd+N adds a new terminal
• Cmd+1-9 focuses terminals by position

Where It's Heading

The workspace will gain a whiteboard canvas view inside project tabs for visual planning. The feed panel is evolving toward an interactive inbox where you can act on items (approve findings, assign tasks) without leaving the Hub.