Projects

A project in Braide is a named reference to a directory on your local filesystem. Projects are the top-level organizational unit — all sessions belong to a project.

What Projects Do

  • Group sessions — Each project has its own list of sessions, keeping conversations organized by context
  • Set working directory — When agents run commands or access files, they operate within the project's directory
  • Store preferences — Per-project settings like approved commands are scoped to the project
  • Enable GitHub integration — If the project directory is a Git repository with a GitHub remote, you can browse and attach issues and pull requests
A project with its session list in the sidebar
A project with its session list in the sidebar

Creating a Project

Click the + button at the end of the project tab bar in the navbar. You'll be prompted to:

  1. Pick a directory — Browse your filesystem to select the project root
  2. Name the project — Give it a descriptive name (this can be changed later)

The project is created and immediately selected as the active project.

Managing Projects

Each project appears as a tab in the navigation bar. You can:

  • Switch between projects by clicking on their tab
  • Rename a project by double-clicking on the tab name
  • Delete a project by clicking the close (×) button that appears when hovering over a tab
  • Reorder projects by dragging and dropping tabs to rearrange them — the order is persisted across sessions

Project Storage

Project data (sessions, metadata) is stored in the ~/.braide/projects/ directory. Each project gets its own subdirectory identified by a unique ID. Deleting a project removes this data but never touches the original source directory.