Workspaces

Workspaces and roles

How to add a project, switch between workspaces, use workspace tools and change your role.

Work without a project

Nora creates a Personal workspace on first launch, so you can start a thread without choosing a folder. Use it for writing, research and anything that isn't tied to a repository. Files your agents create there are saved in ~/.nora/Personal.

Add a project

Add a folder or repository as a workspace to work on it with Nora.

  1. Press Mod+O, or open the workspace picker at the top of the sidebar and choose Add workspace.
  2. In Add project, choose Local folder to open a folder on this computer, or Remote over SSH to work on a server.
  3. Pick the folder. The workspace opens and appears in the picker.

Start a new project

Nora can set up a new project from a framework and the libraries you choose, using an agent.

  1. Press Mod+O and choose New project.
  2. Search for and choose a framework, then pick starter components and testing. Choose Continue to move through the steps.
  3. Choose the agent that should build it, and enter the Project folder name.
  4. To reuse this setup later, tick Save to favorite stacks and give it a name.
  5. Choose Create with agent.

Switch workspaces

Each workspace keeps its own threads, tools and tabs.

  1. Click the workspace name at the top of the sidebar.
  2. Type in Find a workspace… to filter, then click the workspace. Workspaces you opened before but closed are under Recent workspaces.

From the keyboard

Press Mod+Shift+K to open the workspace switcher, or Mod+1 to Mod+5 to open one of your five most recent projects.

Keep a workspace easy to find

In the workspace picker:

Pin it
Click the pin on its row to keep it at the top of the list.
Change its colour
Click its two-letter avatar (Change avatar color) and pick a colour, or Use automatic color.

Go back to workspace home

Workspace home shows what you were working on, with threads that need you first, quick links to the project's tools, and its package scripts.

  1. Click the home button beside the workspace picker (Workspace home). Your open tabs stay open.
  2. Under Pick up where you left off, click a thread to continue it, or choose New thread.
  3. To run a package script, pick it under Project commands and choose Run. It runs in a terminal at the workspace root.

Open and pin workspace tools

Workspace tools, such as Worktrees, MRs, Issues, Documents, Tasks, Terminal, Browser and Workflows, sit in the strip beside the sidebar. Your role decides which are pinned at first. Tools that need Git only work where there is a repository.

  1. Click a tool's icon in the strip to open it.
  2. To open a tool that isn't pinned, click More workspace tools (the … in the strip) and choose it.
  3. To change what the strip shows, click the pin beside a tool in that list. Pins are kept for each workspace.

Change your role

Your role shapes the tools pinned at first, the starters on the new thread screen, which bot templates are suggested and the guidance agents receive. It never grants permissions or changes your model.

  1. Open Settings → General.
  2. Under Work role, choose Change role.
  3. Pick the kind of work you do, or describe your own role, and choose Save role.

Applies to new threads

Existing threads keep the role they started with, including queued work and resumed sessions.

Close or remove a workspace

Open Workspace actions (the … beside the workspace picker) and choose Close workspace, or Remove project to take it out of Nora. To work with it again later, add it again or open it from Recent workspaces.

NextDownload NoraWhat’s newGet support