Conversations
Conversations are the primary way you interact with Workshop. They follow a chat structure and are made up of pairs of user-Workshop interactions called turns. Each conversation lives within a project and maintains its own history, context, and state. You can have multiple conversations within the same project — useful for separating different features, debugging sessions, or exploration threads.Starting a new conversation in a new project
Click the Home button at the top of the left panel, then type your prompt. Starting a conversation from the Home screen creates a new project and assigns the conversation to it.Starting a new conversation in an existing project
Navigate to the project you want from the Home screen, then write your prompt in the input field. The new conversation will be associated with that project, sharing its files, context, and settings.A conversation can only belong to a single project, but a project can contain many conversations.
When to start a new conversation
Start a new conversation when you:- Begin working on a separate feature or task
- Want a clean context window after a long session
- Need to explore an alternative approach without affecting your current thread
- Have used
/compactto condense and continue (the parent becomes read-only)
- Are iterating on the same feature
- Need Workshop to remember recent decisions and context
- Are debugging something discussed earlier in the thread
Projects
A project is a structured container for your work with Workshop. It groups conversations, files, settings, and context around a specific goal or codebase. On your file system, a project corresponds to a specific directory. Projects ensure that all actions, code, and files are associated with the correct context. The environment you set up in one conversation is available to other conversations in the same project.The project screen
Each project has its own page with the following sections:Project Overview
A description rendered from the
README.md file in the project directory.Conversations
A list of all conversations in the project. Click any conversation to navigate to it.
Rules for AI
Project-specific rules rendered from
.workshop/rules.md that guide Workshop’s behavior.Code
A browser for all assets in the project directory.
Creating a new project
Click ”+ New Project” on the Home screen. You will be prompted to choose between:- Create new project under the Workspace directory — use this when starting from scratch. Provide a project name and Workshop creates the directory for you.
- Select existing folder — use this when you have an existing codebase or directory you want Workshop to work on.
Creating a project from a template
Workshop Templates are ready-made starting points. Browse them under Templates on the Home screen. When you select a template, Workshop clones it into your local environment and it becomes available as one of your projects.Project context
Every Workshop project can include a.workshop/ directory at its root containing project-level configuration that Workshop reads automatically — including context files, rules, and custom skills.
For details on the .workshop/ directory structure, context file precedence, and how project memory works, see Context and Memory.