Skip to content
Ryan Stoffel edited this page Oct 29, 2026 · 1 revision

Spaces

A Space groups threads that need no repository of yours. You give it instructions and files, and every thread in it gets them. A Space has no coordinator and can't become a Project.

A Space lives on one computer, and so do its threads and files.

Create a Space

Open the add palette and choose New Space:

  • Classic sidebar: New project or repository in the sidebar's head.
  • New sidebar (beta): New project or Space.
  • The Projects page: New project or Space, then Space.

In Create Space, pick an icon, type a name, and choose Create. The Space's page opens.

New Space shows only when the open computer's plxd supports Spaces.

The Space's page

Part What it holds
Header Projects (back to the Projects page), the Space's icon and name, Pin, and its menu. Hover the icon to change it
Composer Starts a new thread in the Space. Under it, the computers you can run on: this one, and any other with a Space of the same name
Threads The Space's threads, newest first. + adds threads you already have
Instructions What every thread here is told. Add or Edit
Files Files every thread here can read. Drop files on the panel, or click to add. Remove takes one out

A thread in a Space shows the Space's icon and name on its sidebar card and in its crumbs.

Instructions and files

Limit
Instructions 32 KiB
Files 50, uploaded to the Space's computer

Each time a thread's agent CLI starts, Parallax adds the Space's name, its instructions, and its files' paths to the agent's system prompt. The agent reads a file when it helps (0090).

A change reaches a running thread the next time its CLI starts, such as after a restart or a provider switch. Until then it keeps the instructions it started with.

In a mode that asks, Claude Code may ask before reading a file outside the thread's worktree, as it does for an attachment.

Add threads to a Space

A Space holds two kinds of thread:

  • Started in it, from the Space's composer. It stays in the Space.
  • Added to it. It keeps its own repository, worktree, and Git menu, and gets the Space's instructions and files.

To add threads:

  • On the Space's page, choose + beside Threads, check the threads, and choose Add.
  • In a thread, open Thread details from the top bar, then Add to a Space, and pick a Space. The same menu moves the thread to another Space, or Remove from Space takes it out.

A Project's threads can't join a Space.

The Space's menu

Item Does
Pin / Unpin Lists the Space under Pinned in the new sidebar and first on the Projects page
Rename… Renames the Space
Change icon… A Lucide icon and a color, or Upload image
Delete… Deletes the threads started in the Space, its instructions, and its files. Added threads leave the Space and keep working where they were

The new sidebar

The Projects page and Pinned come with the new sidebar, a beta. Turn it on in Settings > Beta > New sidebar. The Space's page and Thread details work the same in either sidebar.

On the Projects page, each Space's card shows its latest thread, how many files it has, whether it has instructions, and how many threads it has. The All, Projects, and Spaces filter shows when you have both kinds.

Decision records: 0069, 0090.

Clone this wiki locally