Projects & Workspace
Project Model
A project is the unit of session grouping and working directory:
- A project can link multiple folders, one marked as the main directory
- Sessions belong to projects; the agent’s sandbox derives from the main directory
- Projects and taskboard share the same data source
Create a Project
- Click “+” in the “Project Tasks” header (or Cmd/Ctrl+Shift+N).
- Enter a name and select folders.
- Mark one as the main directory (where the agent works by default).
Default Project
The system guarantees exactly one default project:
- Cannot be renamed or deleted
- Doesn’t appear in the project dropdown
- Implicitly applies when no project is selected
Session Grouping
- Each project shows the latest 5 sessions by default; click “Show More” to expand
- Projects can collapse/expand; “Collapse All” / “Expand All” in the header menu
- Sessions can be dragged across projects
Project Context
Place AGENTS.md or RULES.md in the project’s main directory. The agent reads it as project context (coding standards, common commands, notes) in every session.
The two files have different jobs:
| File | Role | Put here |
|---|---|---|
AGENTS.md |
Guidance | Project background, tech stack, directory layout, common commands |
RULES.md |
Hard constraints | Must-follow standards (naming, forbidden patterns, security rules) |
Tips for Writing Project Context
- Keep each rule focused; don’t cram ten things into one paragraph
- Avoid conflicting rules; merge or delete the old one when they collide
- Use relative paths (
src/api/, not/Users/you/project/src/api/) - Changes take effect in new sessions; continuing an old conversation may carry the previous habits