Workspaces and Thread Management

SuperBuilder organizes your work into workspaces and threads. Workspaces keep projects separate. Threads are where work happens. Together they give you a clear structure for managing everything your AI agents are doing — across multiple projects, running in parallel, over time.

Workspaces

A workspace maps to a project or a codebase. When you open a folder in SuperBuilder, it creates a workspace for that project. Each workspace has:

• Its own set of threads (conversations with agents)
• Its own file index (SuperBuilder reads and indexes your codebase for better agent context)
• Its own settings — default model, budget limits, provider profile
• Its own git history access

You switch between workspaces from the sidebar. If you're a developer with multiple active projects, you might have 3-5 workspaces open — one per repo.

Threads

A thread is a conversation with an AI agent. Threads are persistent — they don't disappear when you close the app. Every message, every file change, every agent output is saved and accessible.

Each thread has a status that tells you what's happening at a glance:

• Running — an agent is actively working on this thread
• Idle — waiting for your next message or action
• Needs attention — the agent ran into something it can't resolve alone and is waiting for your input
• Done — the task is complete
• Scheduled — a scheduled run is pending

You can see all your threads in the sidebar, sorted by status and recent activity. Threads that need your attention float to the top.

Thread Types

Not all threads work the same way. SuperBuilder has different thread types for different kinds of work:

Standard thread — a full agent conversation. The agent can read and write files, run commands, use tools. The most common type.

In-app chat — a quick conversation thread for questions and explanations. Lower overhead, no file system access by default. Use it when you want answers, not changes.

DB setup — a specialized thread for database schema work. Pre-loaded with context about your database structure and migration conventions.

Finding Past Work

All threads and messages are searchable. Global search lets you find:

• A specific conversation ("that thread where I asked about the auth refactor")
• A specific file change ("when did the agent edit auth/middleware.ts?")
• A specific task ("what was the approach for that payment bug fix?")

Search works across all workspaces and all threads. Your work is never lost.

Thread Organization

Favorites — pin threads you return to frequently. Favorited threads stay at the top of the sidebar.

Archive — move finished threads out of the active view without deleting them. Archived threads are still searchable.

Labels — tag threads with custom labels for easy filtering. Common labels: ready-to-review, blocked, shipped, needs-testing.

Parallel Work

Because each thread runs in its own isolated worktree, you can have multiple threads running simultaneously without conflicts. SuperBuilder shows you all active threads in the sidebar with real-time status updates — you glance at the sidebar to see which agents are done, which are running, and which need your attention.

This is meaningfully different from other AI tools where you wait for one task to finish before starting the next. In SuperBuilder, you queue work across multiple threads, step away, and come back to review the results.

Notifications

SuperBuilder notifies you when threads change status:

• Task done — the agent finished and is ready for review
• Needs attention — the agent needs input before it can continue
• Error — something went wrong and the task stopped

Notifications appear in-app and, if configured, as push notifications on your phone. You don't have to watch the screen waiting for an agent to finish.

Cross-Device Sync

Your workspaces and threads sync across all your devices. Start a conversation on your Mac, check progress from your phone, review the output from your laptop. The thread is always where you left it.

Frequently Asked Questions

How many workspaces can I have?

No hard limit. You can have as many workspaces as you have projects. The sidebar lets you search and switch between them quickly.

Can I share a workspace with teammates?

Yes. Workspace sharing is available for teams. Shared workspaces let teammates see each other's threads, hand off work, and collaborate on the same project.

What happens to threads when I delete a workspace?

Threads are archived, not deleted. You can still access them from the archived threads view even after the workspace is removed.

Can I rename workspaces and threads?

Yes. Both workspaces and threads can be renamed. SuperBuilder also auto-generates thread titles based on the content of the first message, which you can edit.

Is there a limit to how long threads can be?

Threads can be very long, but very long context increases cost and can slow down agent responses. For complex multi-day projects, it's often better to start fresh threads for new sub-tasks, referencing the previous thread for context, rather than keeping one giant thread.