Nora
docs
Get started

Workspace model

Understand how Nora groups projects, worktrees, sessions, context, and repo state into one operating model.

What belongs to a workspace

A Nora workspace is more than a folder picker. It combines the repository, any isolated worktrees, open agent and terminal sessions, specs, task files, changed-file views, browser tabs, and optional remote mounts into one project surface.

How planning and execution stay connected

Specs and task files live with the workspace so planning does not drift away from execution. You can use a spec as the source of truth, generate actionable tasks from it, open a task, and then launch a new agent directly for that task on a fresh worktree.

How to keep the workspace under control

Use the root checkout as the stable home for the project and treat worktrees as disposable working copies for active changes. Keep specs and tasks clear, use read-only sessions for investigation, use write sessions only when they should edit files, and rely on the focused session view to see exactly where work is happening.