Open a project
Open a folder to create a local project, or to return to one you already opened.
Open a folder in the dashboard
- Open the project menu from the arrow beside the project name at the top of the window. In the desktop app you can also choose View → Open Project….
- Choose Create project.
- In Open project folder, browse to the folder, or type its path. Choose New folder to create an empty one.
- Choose Open folder.
The folder does not need to be a Git repository, and you do not need a coding agent installed yet. You can add both later.
The first project does need the git command and an internet connection. Prompt Studio uses git to download the default extensions from GitHub when you open your first folder. It needs git for this download even when your folder is not a Git repository. Without these extensions, the agent list stays empty. If the download fails, see Troubleshooting.

The picker shows folders on the machine running Prompt Studio. The path in this example is /workspace; choose the folder where you want your own tools and files to live.
Open a folder from the terminal
Run pst projects create inside the folder:
cd ~/my-tools
pst projects create
You can also pass a path and a name:
pst projects create "My tools" --path ~/my-tools
Other pst commands find the project from the folder you run them in. See CLI projects for every option.
What happens when you open a folder
- The folder name becomes the project name. You can rename the project in its settings.
- Prompt Studio writes
.pstdio/config.jsonin the folder. This file links the folder to its project, so the docs call such a folder a linked project. Commands such aspst extensions addonly work inside a linked project. A.pstdio/.gitignorekeeps the file out of Git. - The project gets its default workspace: the folder itself. Agent sessions work in this folder and share its files.
- The default extensions add Home, Onboarding, themes, and skills. Onboarding lets you choose agent harnesses and tools for this project; selected extensions install in the background.
Opening the same folder again reopens its project. A subfolder is a separate project, even inside a Git repository. Deleting a project keeps your chosen folder and your own files, but removes the project’s matching .pstdio/config.json link and saved host data. Provider-created workspaces follow their provider’s cleanup rules.
Onboarding opens after creating a project in the dashboard. Choosing Coding installs Workspaces, Terminal, Planner, Reports, Artifacts, and Skill Browser when available. Choose Skip setup to enter the project without installing unsubmitted choices. To stop offering it for future projects, enable Extensions → Onboarding → Settings → Don’t show onboarding. You can also disable the extension for a project. Agent harnesses and optional tools stay off in new projects until selected, even when another project already uses them.
To learn how projects, workspaces, and Git worktrees fit together, read Projects and workspaces.
Find your way around the workbench
The workbench is the shared window where you use your tools and talk to agents. Start here after opening a project:

- The project name at the top takes you back to Start. Its arrow opens the project menu so you can switch projects.
- New conversation opens an agent conversation beside your current tool.
- Open a tool opens the command palette, where you can choose a tool or command. Enabled extensions can also add tools to the sidebar.
- Browse extensions opens the extension settings so you can add tools.
- Settings at the bottom of the sidebar holds runtime options, project options, and extension settings.
If none of the project’s enabled harness extensions is available, Start shows No agent available. You can still use Prompt Studio from your own harness, but sessions within Prompt Studio are unavailable until a harness is available. Choose Browse extensions to inspect the project’s extensions and their failure reasons.
Checking agent availability… means the check is still running. Could not check agent availability means the check failed; it does not mean no agent is installed. Choose Check again to retry. If project setup failed, finish that setup with Retry setup first.
The example project has Notes and Planner enabled, so its sidebar includes Notes and Tickets. Those are extension tools. Your sidebar depends on the extensions you turn on.
Next, add tools.
Updated at: 2026-11-05