# macOS build is not public yet
# join the waitlist from the homepageWhat to install before you start
Before launching Nora, make sure Git is installed and that you have at least one supported agent CLI if you want to run agents immediately. If you plan to use remote workspaces, also set up SSH first. For a fuller checklist, read the requirements page.
What you do first
On first launch, choose a Git repository as the workspace root. Nora is designed around repository-backed work, so the app expects a real project with branches, files, and a working tree rather than a blank chat session.
How to launch a first agent
Open the new agent session dialog, select a detected CLI, give the session a name, choose a task, set read-only or write access, and pick where it should run. For a first run, the safest path is a new worktree with write access so the agent can edit without touching the root checkout.
How to verify the run
Once the session starts, watch the live terminal panel, inspect the current branch and workspace path in the session header, and open the changes panel for the focused worktree. If files changed, Nora shows per-file status, additions, deletions, and a diff view tied to that session.