Concepts
Spaces and the sandbox
A space is a home for one project or team: its own files, memory, skills, apps, automations and jobs, in a sandbox of its own.
What a space is
A space is where a project, a team or any line of work lives. Your agents work in it. It has its own files, memory, skills, tools, apps, automations and jobs, and the agents remember what happened there.
Each space is one tile on the rail at the left of the app. A dot on a tile means a question or approval is waiting. A glowing dot means work is running. Press Ctrl+P (Cmd+P on a Mac) to jump to any space by name, and Ctrl+1 to 9 to switch between the first nine.
The sandbox
A regular space runs in its own small virtual machine: a separate computer inside yours. Agents can install packages, run commands and delete files in it without touching the rest of your computer. Spaces cannot reach each other either.
A space can reach the internet through its network policy (see Security and privacy).
Regular spaces, local spaces and Computer
There are three kinds of space.
- Regular space. Runs in its own virtual machine. This is the default and what almost every space should be.
- Local space. Runs directly on the computer, with no sandbox, as the user account running TurnPanel. Its jobs can read and change your files and TurnPanel's own files. Only workspace admins can create one or be in one, and creating one asks you to confirm that you understand.
- Computer. The one space per machine that also runs directly on it. It appears at the top of the rail, only for admins. In the specs it is called the Super Space.
Shared folders: the way in from your computer
A regular space cannot see your files unless you share a folder with it. A space admin adds one in the space's settings under Folders and chooses Can edit or Read only. Inside the space, a shared folder shows up under /mnt.
Adding or removing a folder restarts the space. Shared folders are slower than the space's own files, so for heavy work, ask an agent to copy a project in. TurnPanel will not share a folder that contains your home folder, its own data or system folders.
In a space, /work is the default working folder, and /space holds the space's instructions, memory, skills, apps and automations.
Space roles
People get one of three roles in a space.
- Viewer. Reads the space and its jobs.
- Member. Also runs jobs and manages the space's content: memory, skills, automations, apps and instruction files. Members cannot delete jobs.
- Admin. Also manages the space's people, runtime (resources, start, stop, restart, shared folders), secrets, installing and removing agents, deleting jobs and agent permission modes.
Space settings
Open a space's settings from its menu. The sections are General (name, icon, instructions), People, Harnesses (agents), Models, Runtime, Folders, Placement and backups, Network, Browser, Web search, Integrations, Extensions, Keys and secrets, and the Danger zone.
Runtime shows the status and lets you set CPUs, memory and disk, and Restart, Stop or Start the space. A change that restarts the space says so first. The Computer and local spaces show fewer sections, because some do not apply to them.