Get started

Core concepts

Threads, bots and workspaces, and how they fit together into one system.

Threads

A thread is a durable conversation with an agent. It remembers its workspace, branch, host, agent, model, permission mode, queued messages, history and the files it changed. Threads keep running when you look away, close the tab or switch workspaces, and they show their state in the sidebar: working, waiting for you, failed or finished.

Starting a thread and starting an agent are the same action. There are no separate agent sessions, terminals or chat tabs to keep in sync.

Bots

A bot is a reusable teammate: a name, a one-line role, instructions, a model, optional memory and an animated face. When you message a bot, the work happens in its own thread, which keeps the instructions it started with. Bots can ask each other for help and work together in group chats.

Nora is the built-in bot. It is listed first and can create bots, read your threads, manage tasks and change settings for you.

Workspaces

A workspace is where work lives. Your Personal workspace is created for you; add a local folder, a Git repository or a remote project over SSH whenever you need one. Each workspace has its own threads, bots, pinned tools and, optionally, its own role.

Tools follow what the workspace can do. A repository shows branches, worktrees, diffs and pull requests; a plain folder shows files without pretending to have Git review.

Agents and providers

An agent runtime, or provider, does the thinking behind a thread: Claude Code, Codex or an ACP agent. Nora talks to each one natively, so models, reasoning options, permission modes, approvals and usage come from the runtime itself rather than a scraped terminal. You can switch agent or model mid-thread; Nora hands the context over.

Roles

Your role, chosen on first launch, shapes Nora's starting tools, starter suggestions, bot templates and the guidance agents receive. Set an app-wide role and override it per workspace. A thread keeps the role it started with; changes apply to new threads only. Roles never grant permissions.

NextDownload NoraWhat’s newGet support