> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoista.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Hoista Desktop

> Find your way around Desktop and its settings.

Desktop is the Hoista app for your projects, providers, agents and settings. It uses the same daemon as the CLI. Closing the window does not stop the daemon, so the CLI and agents keep working.

## The window

![The Projects screen, with the sidebar on the left and project cards on the right](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/projects-light.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=f7ab390539691d4a5f36029a5d36d776)

![The Projects screen, with the sidebar on the left and project cards on the right](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/projects-dark.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=46ca4620c784957d11b151a5a4fc6632)

Projects, the first screen. The sidebar holds the main sections, your recent projects with their status, and the environment switcher.

| Item | What it shows |
| - | - |
| **Projects** | Your projects, problems that need you, and **Found on your providers** |
| **Deploys** | Every deploy across your projects, newest first |
| **Agents** | Connected agents, their access and their activity |
| **Accounts** | Connected provider accounts and providers you can still connect |
| **Billing** | What each provider has billed you this period. See [billing](https://docs.hoista.dev/guides/billing.md). |

Your recent projects are listed under these items. The switcher under the search box picks the [environment](https://docs.hoista.dev/guides/environments.md) the window shows.

## Search and shortcuts

Press **⌘K** to search for a project, a page or an action. In a project, it also offers to copy its `hoist` commands and its project ID.

![The search box open over a project, listing that project's tabs](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/palette-light.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=d0d772bb4edef390d0b396c41f39eccb)

![The search box open over a project, listing that project's tabs](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/palette-dark.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=a2fa07bab10f2ef9e5c34c8de12174bf)

⌘K in the moodboard project: its tabs come first, then everything else that matches what you type.

Hoista answers the usual desktop shortcuts. On Linux, use Ctrl instead of ⌘. Press **⌘/** to see them all in the app; the menu bar lists them too.

| Shortcut | Does |
| - | - |
| ⌘K | Search for a project, a page or an action |
| ⌘1 to ⌘5 | Projects, Deploys, Agents, Accounts, Billing |
| ⌘\[ and ⌘] | Back and forward |
| ⌘R | Refresh what's on screen |
| ⌘N | Deploy something with your agent |
| ⌘, | Settings |

Right-click copies text and links, as in any app.

## A project

Open a project to see its tabs.

![The moodboard project's Overview tab](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/project-overview-light.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=ff9c0582fab2effc167d5df17f776e29)

![The moodboard project's Overview tab](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/project-overview-dark.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=a26370d78afcb5498828ae401ce44bbf)

A project's Overview. The tabs along the top hold everything else about it.

| Tab | Use it to |
| - | - |
| Overview | Check status, recent activity and usage |
| Map | See the project's resources and how they connect |
| Deploys | Follow deploys, redeploy or roll back |
| Logs and Metrics | Read [logs and metrics](https://docs.hoista.dev/guides/logs.md) from the provider |
| Variables and Domains | Manage [variables and domains](https://docs.hoista.dev/guides/environment.md) |
| The provider's name, such as **Railway** | Use the provider's own controls, such as Railway's operations. A project on several providers has one **Providers** tab instead |
| Settings | Rename, link a source, move to another environment, stop watching or delete |

Open a resource from the Map or Overview to [restart, stop or delete it](https://docs.hoista.dev/guides/resources.md).

## Settings

Open **Settings** from the profile menu, or press **⌘,**. Most changes save as you make them.

![Settings open on General, with the theme choice at the top](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/settings-light.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=d972819fae1bbac0b495524afaaeb225)

![Settings open on General, with the theme choice at the top](https://mintcdn.com/mirt-lab/bTbgaR1vteaGCpS-/assets/screens/settings-dark.webp?fit=max\&auto=format\&n=bTbgaR1vteaGCpS-\&q=85\&s=a288d5fe737eceee944ffe013b021bb1)

Settings → General. The sections on the left are listed below.

| Section | Controls |
| - | - |
| General | Profile, appearance, startup, notifications and how long to keep history |
| Agents | Connected agents, how they reach Hoista, and connection requests |
| Vault | Credential storage |
| Safety | Build isolation and cutting off every agent at once |
| Webhooks | Destinations, signing secrets and delivery history |
| Instances | This computer and your remotes: add, sign in, switch and remove |
| Command line | Whether the `hoist` command is set up |
| Updates | Installed version and new releases |

> [!WARNING]
>
> Safety settings change how the daemon works. Read [build isolation](https://docs.hoista.dev/security/builds.md) before you allow builds without it.

When an agent asks to do something sensitive, Desktop shows the request with its target. See [approvals](https://docs.hoista.dev/security/approvals.md).

## Related

> [card] [Quickstart](https://docs.hoista.dev/getting-started/quickstart.md)
>
> Connect a provider and add your first project.

> [card] [Logs and metrics](https://docs.hoista.dev/guides/logs.md)
>
> Read what the provider reports.

> [card] [Approvals](https://docs.hoista.dev/security/approvals.md)
>
> What Desktop asks you before an agent acts.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.