Repository navigation
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.
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.
| 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.
| 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.
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.
| 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 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.
Start
Using Parallax
Your computers
Maintenance
Contributing