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

# Moxus Desktop

> Use Moxus Desktop for local AI programming work across projects, sessions, files, terminals, and deliverables.

Moxus Desktop is Moxus's native AI programming workspace. It brings project sessions, Agent activity, terminals, file changes, and generated deliverables together in one desktop app.

Unlike Cursor, Claude Code, or Codex, **Moxus Desktop does not require you to enter a Moxus API key manually.** Sign in to your Moxus account and select any model available to that account.

<Info>
  Download the current macOS or Windows installer from the [Moxus Desktop download page](https://moxus.cloud/desktop). The app checks for updates at startup and in Settings → About.
</Info>

## What you can do

<Columns cols={2}>
  <Card title="Work by project" icon="folder-kanban">
    Open a local folder and keep multiple independent AI sessions in the same project.
  </Card>

  <Card title="Use general sessions" icon="message-square">
    Start a task without opening a project. The work stays in a separate Moxus workspace.
  </Card>

  <Card title="Follow execution" icon="list-checks">
    View messages, commands, approvals, terminal activity, and file changes while a task runs.
  </Card>

  <Card title="Review results in context" icon="panel-right-open">
    Preview files, diffs, PDFs, images, videos, and local web pages beside the conversation.
  </Card>

  <Card title="Search the live web" icon="search">
    Search for current information and review the search process and clickable sources.
  </Card>

  <Card title="Manage multiple sessions" icon="messages-square">
    Search, rename, pin, or archive sessions to keep project work organized.
  </Card>
</Columns>

## Before you start

You need:

* A Moxus account that can sign in to the desktop app.
* Account balance available for the target model.
* An installer matching your operating system.

**Normal use of Moxus Desktop does not require creating or copying an API key.** API keys are used for API calls and third-party clients.

## First use

<Steps>
  <Step title="Install and open Moxus Desktop">
    Download the installer for your operating system, complete the installation, and open the app.
  </Step>

  <Step title="Sign in to Moxus">
    Sign in with the same account you use on the Moxus website. The app will load the models available to that account.
  </Step>

  <Step title="Choose a project or create a general session">
    Select a local project folder for an existing codebase. Create a general session for ideas, planning, or tasks outside a project.
  </Step>

  <Step title="Select a model and send a task">
    Select a model in the input area, describe the work, and send it. The workspace streams the response and Agent activity.
  </Step>

  <Step title="Review changes and deliverables">
    Before keeping or using the result, inspect file changes, terminal output, previews, and generated deliverables from the conversation or right panel.
  </Step>
</Steps>

## Projects, sessions, and general workspaces

### Project workspaces

A project workspace is linked to the local folder you select. Use it for codebase development, feature changes, troubleshooting, or tasks that need existing files. A project can contain multiple sessions, so each task keeps its own conversation and context.

### General sessions

General sessions do not require a local project. They are useful for planning, research, short scripts, document work, or validating an idea before entering a codebase. General-session work is stored in a separate Moxus workspace and is not written into a project folder by default.

### Independent sessions

Switching projects or sessions does not mix their conversation histories. A running session can continue while you view another one. When you reopen the app, recoverable history is reloaded when available. The sidebar supports searching, renaming, pinning, and archiving sessions; archiving hides a session from the regular list without deleting it.

### Queued follow-ups

You can enter follow-up requests while a task is running and queue them for sending. Edit queued messages before they are sent when you need to add constraints, change direction, or provide the next step.

## How Agent activity is shown

In addition to the final answer, a request may show:

| Item         | Meaning                                                                    |
| ------------ | -------------------------------------------------------------------------- |
| Message      | A model response or a question waiting for your answer.                    |
| Process      | Progress through reasoning, search, or task stages.                        |
| Command      | A command the Agent asks the local runtime to execute.                     |
| Approval     | An operation that needs your confirmation before continuing.               |
| User input   | A question or missing detail the Agent needs from you during execution.    |
| File changes | Files that were created or modified and can be inspected.                  |
| Terminal     | Terminal output associated with the current session.                       |
| Web search   | Search progress and sources shown while the Agent researches the live web. |

Review changes in the diff and preview panels. Pay particular attention to approvals involving projects, files, or running services.

<Warning>
  When a task requires it, Moxus Desktop can read and modify content in the opened workspace. Confirm the selected folder and review every approval and file change. Unless your organization permits it, do not place credentials, production keys, or other sensitive information in prompts or project files.
</Warning>

## Files, terminals, and deliverables

### File review and previews

The right panel can show a file tree and preview common text files, images, Markdown, PDFs, videos, diffs, and local web pages. After reviewing a turn's file changes, you can apply or roll them back. DOCX, XLSX, PPTX, and other Office files usually open in the operating system's default app.

### Session terminals

Terminal tabs belong to the current session. Command output and running processes stay associated with the task that created them and do not mix with other projects or conversations.

### Generated deliverables

Moxus Desktop can generate document deliverables such as PPTX, DOCX, XLSX, and PDF. Generated files appear in the conversation as artifact cards and can be opened, downloaded, or shown in their folder. Charts and SVG diagrams can appear directly in the conversation; PDFs and videos can be previewed in the app, while Office files usually open in the system default app.

## Models and billing

The Desktop model list contains the models currently available to your Moxus account. If a model is missing, it is not currently available in Desktop.

Requests consume your Moxus account balance. See [Models and pricing](/en/overview/models-and-pricing) for current prices and [Dashboard and usage](/en/platform/dashboard-and-usage) for request records. Desktop also keeps local account records for completed desktop requests for reference.

## Updates

Moxus Desktop checks for updates at launch, after remaining open for a while, and when the window returns to the foreground. You can also check manually from the sidebar update entry or in Settings → About. Install an available update in the app and restart as prompted.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="I cannot sign in">
    Confirm that the same Moxus account can sign in on the website, then check your network and try again. If the website works but the desktop app does not, include the error and app version when contacting support.
  </Accordion>

  <Accordion title="The model I need is missing">
    Desktop only shows models currently available to your account. If a model is not in the list, it is not currently available in Desktop; choose another available model.
  </Accordion>

  <Accordion title="A task is waiting for approval">
    Open the approval row and read the requested operation before continuing. Rejecting an approval may stop the current step; enter a new request if you want the task completed another way.
  </Accordion>

  <Accordion title="I cannot find a generated file">
    Open the artifact card in the message that generated the file, then use Open, Download, or Show in folder. Files created in a project can also be found in the project tree and change list.
  </Accordion>

  <Accordion title="The result is incomplete or the request failed">
    Check the latest process information and terminal output, then open [Dashboard and usage](/en/platform/dashboard-and-usage) to confirm whether the request reached Moxus, which model was used, and whether an API error was recorded.
  </Accordion>
</AccordionGroup>

## Related documentation

* [Models and pricing](/en/overview/models-and-pricing)
* [API keys](/en/platform/account-and-keys)
* [Dashboard and usage](/en/platform/dashboard-and-usage)
* [Cursor integration](/en/integrations/clients/cursor)