Tools

Files and changes

How to browse and edit files, review diffs, comment on them, commit and push, and look back through your commit history.

Open the right sidebar

Files, Git and the other workspace panels live in the right sidebar. Press Mod+Shift+B to show or hide it, then pick a tab at the top. Git, Vercel and Forge only appear when the workspace is a Git repository.

Git
Changed files, commits, branches, pull and push, and recent commits.
Files
The workspace's file tree.
Context
Conversation context from your threads (Detected) and imported bundles (Imported).
Vercel
The linked Vercel project's deployments.
Forge
GitHub or GitLab pull or merge requests, issues and pipelines.

Open and edit a file

Use the Files tab when you want to read or change a file yourself.

  1. Open the Files tab in the right sidebar.
  2. Click a file to open it in an editor tab, or type in Search file contents to find it by what it contains.
  3. Make your changes and press Mod+S to save.

Create, rename and delete from the tree

Right-click a folder for New file, New folder or Delete folder. Right-click a file for Rename file or Delete file.

Read a Markdown file

Plans, specs and notes are usually Markdown. When you open a .md file, switch between Preview for the rendered page, Split to edit beside the preview, and Edit for the source. File links in a chat also open in this viewer instead of leaving Nora.

Review a diff

Check what changed before you commit or ask for fixes.

  1. Open the Git tab. Changed files are listed with their status and line counts.
  2. Click a file to open its diff. Additions are green and deletions red.
  3. To see every change at once, choose Full diff above the list.

Changes from one thread

To review only what a particular thread changed, open its Thread details instead. The card at the end of each turn also lists the files that turn changed.

Comment on a diff and send it to an agent

Leave notes on specific lines, then hand them all to a running agent in one message.

  1. Open a file's diff, or Full diff, from the Git tab.
  2. Hover a changed line and click the + button beside it.
  3. Write what should change and choose Add comment. Repeat on other lines.
  4. Your comments collect in the Diff review tray at the bottom of the Git tab. Remove one with its ×, or clear them all with the trash button.
  5. Pick the recipient in Agent to receive diff review and choose Send to agent.

No agent running?

The tray says Start an agent in this project to send these comments. Choose New agent to start one, then send. Comments are cleared once they are sent.

Commit your changes

Commit from the Git tab without opening a terminal.

  1. Open the Git tab.
  2. Choose which files to include with each file's checkbox, or use All and None.
  3. Type a message in Write commit message, or click the sparkles button (Generate commit message with AI) to have one written for you.
  4. Choose Commit, or press Mod+Enter in the message box.

Choose the model that writes messages

Generated commit messages use the model you set in Settings → AI.

Discard changes to a file

Hover the file in the Git tab and click Discard file changes (the undo arrow). For a new, untracked file the button is Delete untracked file. To make a quick fix instead, click Edit file to open it in the editor.

This cannot be undone

Discarded edits are not kept anywhere. Commit or copy anything you might want back first.

Switch branch

Click the branch name at the top of the Git tab (its tooltip reads Switch branch from your current branch) and pick another branch from the list.

Pull and push

Sync your branch with its remote from the Git tab.

  1. In the Git tab, choose Pull to bring in remote commits, or Push to send your local commits. Hover either button to see how many commits it will move.
  2. If the branch has no upstream, a notice says so. Choose Set upstream and pick the remote branch to track, then push.

Buttons greyed out?

Pull is disabled when there is nothing to pull and Push when there is nothing to push. Both are disabled while you are inspecting an earlier commit.

Open a pull or merge request

The button reads Create PR on GitHub and Create MR on GitLab. Push the branch first.

  1. In the Git tab, choose Create PR (or Create MR).
  2. Fill in Title and Description, and check the Source and Base branches.
  3. Choose the submit button, such as Create PR feature -> main.

Inspect an earlier commit

Look back at what a recent commit changed without leaving your work.

  1. In the Git tab, open Recent commits. Each commit shows its author, date and short hash.
  2. Click a commit to list the files it changed, then click a file to read its diff.
  3. Choose Back to working tree to return to your uncommitted changes.

Open a thread's checkout in your IDE

Open Thread details at the top right of a thread and use the Open in button. To change which editor it opens, set Default IDE in Settings → General.

NextDownload NoraWhat’s newGet support