Overview
Workspace is the mode where you run coding agents and keep the material around them: tickets, notes, scheduled jobs and pull requests. Everything is filed under a group, and most of it under a project inside that group.
The Workspace tree
The sidebar shows a tree:
- Group: the area a piece of work belongs to. See Groups.
- Project: a repository or folder inside a group. See Projects.
- Sessions, Notes, Boards and Automations: listed under each project. A group can also hold its own notes, boards, automations and sessions.
Click a group to open its overview page, or a project to open its overview page. Each overview lists the sessions, notes, boards, automations and meetings of that group or project, with a button to create each one.
Co-workers is at the bottom of the sidebar.
Groups
A group is either an organization group or a private group.
| Organization group | Private group | |
|---|---|---|
| Who owns it | Your organization | You |
| Who creates it | An admin | You, if policy allows |
| Tracked by the organization | Yes | No |
| AI-DLC | Applies | Does not apply |
| Badge | ORG | None |
The same groups appear in Meetings, SQL, NoSQL, REST, SSH and Explorer.
What a project holds
| Item | What it is | Page |
|---|---|---|
| Sessions | A coding agent working in the project's folder | Sessions |
| Boards | Columns of tickets, synced with repository issues or Jira if you choose | Board |
| Notes | Markdown documents filed under the project | Notes |
| Automations | A prompt that a coworker runs on a schedule | Automation |
| Review | Pull requests for the project's repository, opened from the board | Board |
Coworkers are not filed under a project. They are named agent profiles that you use on tickets, pull request reviews and automations. See Coworkers.
Create something
The New menu in the sidebar header and on the overview pages has the same items everywhere:
| Item | Notes |
|---|---|
| New session | Needs a project with a linked folder. On an unlinked project the item is Link folder… |
| New project | Private groups only. Projects in an organization group are added by your organization |
| New note | Filed under the project or group you are in |
| New board | Filed under the project or group you are in |
| New automation | Filed under the project or group you are in |
| New group | Creates a private group, if policy allows |
You can also right-click a group or project in the tree to get the same create items for that row.
Sessions
A session needs a folder on your computer, so link a folder to the project first.
Boards
Notes
Automations
The project overview page
Click a project in the tree to open its overview. It shows:
- Whether the project is linked to a folder on this computer or local only
- A New session button, or Choose folder… if no folder is linked yet
- Sections for Sessions, Notes, Boards, Automations and Meetings
Notes filed at group level also appear in the project's notes, marked GROUP.
The group overview page
Click a group to open its overview. It has sections for Projects, Running sessions, Sessions, Notes, Boards, Automations, Coworkers and Meetings. In an organization group, the Projects section also lets you choose where the group's repositories live on your computer and clone the ones you do not have yet.