# The Orbit guide

Learn how to organise projects, tasks, notes, files, and code in Orbit.

- [Installation](/guide/getting-started/installation/index.md): Download the right macOS installer, install Orbit, and open it for the first time.
- [Your first project](/guide/getting-started/first-project/index.md): Create a project, add your first task and note, and optionally link your code.
- [Finding your way around](/guide/getting-started/interface/index.md): Find your projects, learn what each section is for, and use the app menus.
- [Managing projects](/guide/projects/managing-projects/index.md): Edit details, customise icons and tags, duplicate, archive, restore, and remove projects.
- [Search and keyboard shortcuts](/guide/projects/search-navigation/index.md): Find projects and their content, use commands, and navigate without a mouse.
- [Links and favourites](/guide/projects/links/index.md): Save reference URLs with categories and notes, then keep important links close.
- [Folders and repositories](/guide/sources/folders-repositories/index.md): Link code on your Mac, add a hosted repository, or clone a local copy.
- [Local inspection](/guide/sources/local-inspection/index.md): Refresh information about your code and fix missing or inaccessible folders.
- [Dependency checks](/guide/sources/dependency-checks/index.md): Check your project's packages for available updates and known security issues.
- [GitHub and GitLab connections](/guide/connections/git-providers/index.md): Connect repository accounts, choose token permissions, and manage saved connections.
- [Repository activity and inbox](/guide/connections/repository-activity/index.md): See commits, pull or merge requests, issues, and build results from GitHub or GitLab.
- [Task cards](/guide/tasks/cards/index.md): Create and edit tasks, add Markdown descriptions and attachments, and move work between lists.
- [Task lists and board layout](/guide/tasks/lists/index.md): Arrange your task board into lists that match the way you work.
- [Paste tasks and create cards from text](/guide/tasks/bulk-tasks/index.md): Import a plain-text task list or turn selected document text into a card draft.
- [Scratchpad notes](/guide/knowledge/scratchpad/index.md): Capture rough notes, understand autosave, and review suggested actions.
- [Documents and Markdown](/guide/knowledge/documents/index.md): Write reference documents, preview Markdown, import a folder, and turn selections into tasks.
- [Assets and file organisation](/guide/knowledge/assets/index.md): Upload, preview, find, rename, and move project files and nested folders.
- [Secrets and the vault](/guide/secrets/vault/index.md): Protect your project credentials with a PIN, and manage when secrets lock.
- [Importing and exporting .env files](/guide/secrets/env-files/index.md): Paste environment entries, preview a file import, and export selected secrets safely.
- [PIN changes and recovery](/guide/secrets/recovery/index.md): Change your PIN or recover access with Touch ID or a recovery code.
- [Scratchpad AI setup](/guide/integrations/scratchpad-ai/index.md): Connect an AI provider, choose a model, and control how notes become proposed actions.
- [Orbit MCP server: connect an AI client](/guide/integrations/mcp/index.md): Set up the Orbit MCP server, discover its tools, and safely read and update your local developer workspace.
- [General, appearance, and sounds](/guide/settings/preferences/index.md): Choose startup behaviour, theme, motion, sidebar appearance, and interface sound settings.
- [Project statuses and task defaults](/guide/settings/project-defaults/index.md): Customise project groups and the initial task lists used by new projects.
- [Tools and runtimes](/guide/settings/runtimes/index.md): Help Orbit find your development tools, or choose a specific installed version.
- [Local storage and offline use](/guide/settings/local-data/index.md): Know what Orbit saves, what remains in source folders, and which features need the network.
- [Exporting and importing a workspace](/guide/settings/export-import/index.md): Back up your workspace or move it to another Mac, including the steps to restore it.
- [Free, Pro, and licence activation](/guide/settings/license/index.md): Compare Free and Pro, activate your licence, and manage access on your devices.
- [Updating Orbit](/guide/settings/updates/index.md): Check for releases, download an update, and restart after saving your work.
- [Everyday workflows](/guide/help/workflows/index.md): Put projects, tasks, notes, sources, and checks together in practical routines.
- [Troubleshooting](/guide/help/troubleshooting/index.md): Resolve installation, saving, folder, provider, runtime, import, and connection problems.