---
title: A tour of Ysra
sidebar_title: Tour of the app
description: Where everything is in the Ysra portal — the sidebar, Build and Ask, sessions, the workspace pages — and the keyboard shortcuts that get you around.
---

Ysra runs in your browser (the **portal**) and on your phone. This page walks
through the portal; see [Mobile app](../mobile/index.md) for the phone.

## The sidebar

From top to bottom:

- **Workspace switcher** — the workspace you're in. Everything below belongs to
  it.
- **Build / Ask** — the two modes of the composer: Developer work or Knowledge
  questions.
- **New session** — start something new (++cmd+n++ / ++ctrl+n++).
- **Sessions** — recent sessions with their state; **See all** opens the full
  list with filters.
- **Your account** — your name and the wallet balance at the bottom.

## Home

The home screen is the composer.

- In **Build**: *What should Ysra build?* — a brief, a repository, a branch, a
  quality level and a budget. Below it, **Start from** playbooks and **Pick up
  where you left off**. See [Start a session](../developer/start-a-session.md).
- In **Ask**: *What do you want to know?* — who to chat with, which sources, and
  Answer or Deep dive. See [Knowledge](../knowledge/index.md).

![The Build composer with Start from playbook cards](../assets/screens/home-composer.webp){ width="1600" height="1280" }

## A session

Opening a session shows the [workroom](../developer/workroom.md): the
conversation, a live canvas, and panels for Mission, Editor, Plan, Review,
Checks, Shell and Audit.

## Workspace pages

| Page | See |
|---|---|
| Files | [Workspaces and files](../workspace/index.md#files) |
| Rules & instructions | [Rules and instructions](../developer/rules.md) |
| Playbooks | [Playbooks](../developer/playbooks.md) |
| Experts | [Experts](../knowledge/experts.md) |
| Memory | [Memory](../knowledge/memory.md) |
| Workers | [Workers](../workers/index.md) |
| Projects | [Projects](../developer/projects.md) |
| Integrations | [Integrations](../integrations/index.md) |
| Wallet & usage | [Wallet and usage](../workspace/wallet.md) |
| Account settings | [Account settings](../workspace/settings.md) |
| This workspace | [Managing a workspace](../workspace/index.md#managing-a-workspace) |

## Keyboard shortcuts

| Shortcut | Does |
|---|---|
| ++cmd+k++ / ++ctrl+k++ | Command palette: search sessions, repositories and playbooks, and jump anywhere. |
| ++cmd+n++ / ++ctrl+n++ | New session. |
| ++enter++ | Send the brief or question. |
| ++shift+enter++ | New line in the composer. |

## Layouts

On a narrow window the workroom switches to tabs at the bottom, so the
conversation and each panel get the full width.