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

# Learn the interface

> Walk the desktop window by area: Home, Extensions, sessions, chat, file tree, Git, terminal, search, and Settings.

The desktop app is a full window, not a plugin sidebar. Learn where things live first. How to use each area is on the pages that follow.

## Home

Launch opens Home. You can:

* Search or pick an existing project
* **Add project**
* See branch / worktree info

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/home-workspace.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=5353bc1c92edd044ecd422fafe657f24" alt="Home: choose or add a project" width="100%" data-path="images/desktop/home-workspace.png" />

Selecting a project opens the main window.

## Extensions

In the left bar, click **Extensions** (same level as **Home**). The center becomes a top bar: Usage, AI frameworks, Skills, Mcps, and more.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/extensions-view.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=d9b6f450a588f16d0fd1c3ddeeb9ad54" alt="Extensions entry in the left bar and the top bar" width="100%" data-path="images/desktop/extensions-view.png" />

Usage opens by default. You can keep managing Skills / Mcps. The other top-bar entries are not shipped yet.

Details: [Extensions](/en/desktop/extensions).

## Main window

Typical layout, left to right:

| Area           | What it is                                               |
| -------------- | -------------------------------------------------------- |
| Sidebar        | Session list, project switcher                           |
| Center         | Chat canvas and input                                    |
| Right / bottom | File tree, Git, terminal, search, Plan, and other panels |
| Top bar        | Search, Settings, window controls                        |

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/app-overview.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=c65450255166dd956fc337300bfcda29" alt="Main window overview" width="100%" data-path="images/desktop/app-overview.png" />

You can drag panel width and height. The layout is remembered.

The next sections look at each area.

## Session list

The left sidebar lists sessions for the current workspace. You can search, star, rename, delete, or start a new session.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/history-sidebar.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=41ca91c9acd9217a3144801bae801ebc" alt="Sidebar session list" width="100%" data-path="images/desktop/history-sidebar.png" />

Details: [Sessions and history](/en/desktop/chat/sessions).

## Chat canvas

The center is the current session: messages, thinking, tool calls, and diffs. The input sits at the bottom.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/chat-canvas.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=d5566551c686fd03fb3d9ea7c8101a23" alt="Chat canvas" width="100%" data-path="images/desktop/chat-canvas.png" />

The bottom of the input switches provider, model, and mode.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/chat-input.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=5563407dfa5e16a8abb9bd4497d0e787" alt="Input and bottom pickers" width="100%" data-path="images/desktop/chat-input.png" />

Details: [Chat area](/en/desktop/chat/overview) and [Input](/en/desktop/chat/input). Permission modes: [Modes and permissions](/en/desktop/chat/modes).

## File tree

Browse files in the current workspace. You can preview, rename, or drag a file into the input.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/file-tree.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=aa666dde29e4b829a2c418c80acf7775" alt="File tree" width="100%" data-path="images/desktop/file-tree.png" />

Details: [Workspace and panels](/en/desktop/workspace/overview).

## Git panel

Review changes, stage, commit, and browse branches and history. You can also generate a commit message with AI.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/git-panel.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=afec2ba58233ce07fd4955417039120b" alt="Git panel" width="100%" data-path="images/desktop/git-panel.png" />

Details: [Git and commit](/en/desktop/workspace/git).

## Terminal

Open a terminal inside the app so you do not switch to an external window. Use it to run commands while you watch AI output.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/terminal-panel.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=f3f730a03d4247d07b6e36c1e25f5b7b" alt="Terminal panel" width="100%" data-path="images/desktop/terminal-panel.png" />

Details: [Workspace and panels](/en/desktop/workspace/overview).

## Global search

One search box covers files, sessions, history messages, skills, and commands.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/search-palette.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=aa502e14047bc2f7057925ef6b5d4d00" alt="Global search" width="100%" data-path="images/desktop/search-palette.png" />

Details: [Workspace and panels](/en/desktop/workspace/overview).

## Settings

After you open Settings, entries are on the left and the matching form is on the right. Providers and CLIs live under **CLI configuration**.

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/desktop/settings-sidebar.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=010734252c6562a1428e4adffc11ca03" alt="Settings sidebar" width="100%" data-path="images/desktop/settings-sidebar.png" />

Full map: [Settings overview](/en/desktop/settings/overview).

## Next steps

<Columns cols={2}>
  <Card title="Chat area" icon="message-square" href="/en/desktop/chat/overview">
    Messages, thinking, tool calls, and status.
  </Card>

  <Card title="Input" icon="keyboard" href="/en/desktop/chat/input">
    `@`, `/`, attachments, and the bottom pickers.
  </Card>

  <Card title="Workspace and panels" icon="folder" href="/en/desktop/workspace/overview">
    File tree, terminal, search, and Plan.
  </Card>

  <Card title="Git and commit" icon="git-branch" href="/en/desktop/workspace/git">
    Changes, commits, and AI commit messages.
  </Card>

  <Card title="Extensions" icon="blocks" href="/en/desktop/extensions">
    Usage, Skills, and MCP.
  </Card>
</Columns>
