The Orbit guide.

Download the right macOS installer, install Orbit, and open it for the first time.

Create a project, add your first task and note, and optionally link your code.

Find your projects, learn what each section is for, and use the app menus.

Edit details, customise icons and tags, duplicate, archive, restore, and remove projects.

Find projects and their content, use commands, and navigate without a mouse.

Save reference URLs with categories and notes, then keep important links close.

Link code on your Mac, add a hosted repository, or clone a local copy.

Refresh information about your code and fix missing or inaccessible folders.

Check your project's packages for available updates and known security issues.

Connect repository accounts, choose token permissions, and manage saved connections.

See commits, pull or merge requests, issues, and build results from GitHub or GitLab.

Create and edit tasks, add Markdown descriptions and attachments, and move work between lists.

Arrange your task board into lists that match the way you work.

Import a plain-text task list or turn selected document text into a card draft.

Capture rough notes, understand autosave, and review suggested actions.

Write reference documents, preview Markdown, import a folder, and turn selections into tasks.

Upload, preview, find, rename, and move project files and nested folders.

Protect your project credentials with a PIN, and manage when secrets lock.

Paste environment entries, preview a file import, and export selected secrets safely.

Change your PIN or recover access with Touch ID or a recovery code.

Connect an AI provider, choose a model, and control how notes become proposed actions.

Set up the Orbit MCP server, discover its tools, and safely read and update your local developer workspace.

Choose startup behaviour, theme, motion, sidebar appearance, and interface sound settings.

Customise project groups and the initial task lists used by new projects.

Help Orbit find your development tools, or choose a specific installed version.

Know what Orbit saves, what remains in source folders, and which features need the network.

Back up your workspace or move it to another Mac, including the steps to restore it.

Compare Free and Pro, activate your licence, and manage access on your devices.

Check for releases, download an update, and restart after saving your work.

Put projects, tasks, notes, sources, and checks together in practical routines.

Resolve installation, saving, folder, provider, runtime, import, and connection problems.