> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aosplane.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aosplane.io/_mcp/server.

# Desktop app

**AOSplane Console** is the desktop app for your coding sessions. It keeps your projects, sessions and conversations side by side in one window, and its Dock icon shows how many sessions are waiting on you.

> **Note**
>
> The desktop app is for macOS, on Apple silicon and Intel Macs. On Windows and Linux, use the [web dashboard](/dashboard).

## Install and sign in

#### Download

Download the disk image from [downloads.aosplane.io/desktop/AOSplane-Console.dmg](https://downloads.aosplane.io/desktop/AOSplane-Console.dmg).

#### Install

Open the disk image and drag **AOSplane Console** into your Applications folder. Then open it.

#### Continue in browser

Choose **Continue in browser**. Your browser opens the AOSplane sign-in page.

#### Sign in

Sign in as you do on the web. When the browser asks, let it open AOSplane Console. The app opens on your projects.

If you closed the browser tab too soon, choose **Open the browser again**. You stay signed in on this Mac until you choose **Sign out** in the account menu at the bottom of the sidebar.

## What you can do

* **Start a session.** Choose **New session** in the sidebar, or press <kbd>⌘</kbd> <kbd>N</kbd>. See [Start a session](/start-a-session).
* **Follow and steer it.** Chat with the agent and answer its permission requests, with the terminal and the changes beside the conversation. See [Chat and approve requests](/session-chat).
* **Work in tabs.** <kbd>⌘</kbd> <kbd>T</kbd> opens a tab, <kbd>⌘</kbd> <kbd>W</kbd> closes it and <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>T</kbd> reopens the last one you closed.
* **Find anything.** Press <kbd>⌘</kbd> <kbd>K</kbd> to search your projects and sessions.
* **See what needs you.** The Dock icon's badge counts the sessions waiting on you in every project.
* **Open the rest on the web.** **Billing** and **Settings** in the account menu open in your browser.

## Continue a Claude Code session in the cloud

If you started work with Claude Code on your Mac, you can carry it on in AOSplane with the whole conversation.

#### Open the project

Open the project the session should continue in. It needs a Claude Code agent.

#### Open the list

Choose **Import session** in the sidebar, or **File › Import Claude Code Session…**.

#### Pick a session

Choose a session from the list. Sessions in the project's repositories are listed first. A new session starts with the conversation so far.

## Good to know

* An imported session starts private. Share it from the web dashboard if you want others to see it.
* The cloud session works from GitHub, so changes you haven't pushed stay on your Mac. If the branch was never pushed, the session starts from the default branch.
* A session from a repository the project doesn't link can't be imported.
* **Help** has **AOSplane Documentation**, **Keyboard Shortcuts** and **Report a Problem…**. See [Keyboard shortcuts](/keyboard-shortcuts) and [Report a problem](/report-a-problem).

## Updates

The app checks for a new version when it opens and every six hours, and installs it in the background. When it's ready, a message says so (for example **AOSplane Console 0.10.0 is ready**). Choose **Restart** to finish.

To check now, choose **AOSplane Console › Check for Updates…** in the menu bar. The app says **You're up to date**, or downloads the new version and offers the restart.

## Related

* [Mobile app](/mobile-app)
* [MCP server](/mcp-server)