Skip to content

Latest commit

 

History

History
130 lines (87 loc) · 8.19 KB

app.mdx

File metadata and controls

130 lines (87 loc) · 8.19 KB
title The App
description Read the work, answer questions and work beside your agent’s conversation.
mdx
format
mdx

import { Card, CardGroup, Steps, Step, Tabs, Tab, Tip, Note, Screenshot, NextSteps } from "@site/src/components/kit";

Read the task on the left and work with your agent on the right. Use the desktop App on macOS, Windows or Linux, or run qualitylayer app for the same workspace in your browser.

Search, Home, Artifacts and your tasks and Chats by project. **+** starts a **Task** or a [Chat](chat.mdx). Where the task stands, and its result. A person icon marks the two steps you approve. **Conversation**, **Terminal** and **Files**, beside the page.

The Agent status chip in the top bar says whether your agent is working, needs you, is quiet or has stopped.

The sidebar {#sidebar}

Projects group tasks by repository, with tasks waiting on you first. A row shows the step strip, coloured by stage, and live agent activity; amber means it needs you. Its toggle opens the task lists Claude Code, Codex and OpenCode report, and their helpers.

  • Right-click a project to rename, recolor or hide it; right-click a task to rename, archive or delete it.
  • The foot shows plan limits or today's cost. With machines, the head switches computers.
  • View options filters names, groups and row sizes. Last activity keeps tasks changed in the last 24 h, 3 d or 7 d; working and open tasks stay visible.
  • Drag past the narrowest width to collapse the sidebar into a rail of Home, Artifacts, waiting and running tasks, plan limits and Settings. Pull the rail outward to reopen it.

⌘K searches actions, projects, tasks and files; ⌘P opens a file in the current task. Use Ctrl instead of ⌘ on Windows and Linux.

More shortcuts in the installed App
Shortcut Action
⇧⌘N New task
⌘B / ⌘J Toggle the left / right sidebar
⌘1 / ⌘2 Home / Artifacts
⌘, Settings

A focused Terminal keeps the agent's keys, including Ctrl+Enter for Claude Code's send now.

Home {#home}

Questions, approvals, waiting Chats and agents that stopped early. Active work, ten rows at a time. Your three newest shipped tasks.

When nothing waits or runs, one All clear line offers New task. A request you typed into New task and closed waits on Home with Continue. Notifications arrive when you can act: an agent needs you, it is your turn, or a run stopped early.

Answering questions {#questions}

Your turn shows one question; its numbered strip lets you answer in any order. Where choices have facts, the recommended one is open and the others fold to one line. A question about a screen shows that screen in the card. Answers are saved immediately and never approve the Plan or the change. If you pause or stop the agent, it resumes only when you choose.

Answer with the keyboard
Key Action
1–9 Pick a choice
R / A Take this recommendation / all recommendations in the batch
T Write your own answer, then Send
M Tell me more
Enter Take the recommendation when the card is focused

Documents and your agent {#comments-and-artifacts}

Every document, artifact, review and record, plus **Review the code** and **View changes**. **Records** opens `records/`, `evidence/` and `agents/`. A whole document, with **On this page** and **Copy document**. Step documents end with **For agents**.

Copy as Markdown keeps Mermaid and local picture names; Copy formatted includes PNG pictures. Working artifacts are compact entries in Files; Open full size opens the whole page.

Select a passage, mark code lines or mark a spot on an artifact. The quick feedback field opens beside it; write your remark, add files or paste an image, then send it to your agent's Conversation or Terminal. A request never approves a Plan, changes approved scope or settles the final approval.

Code review {#code-review}

Open Changes in the header or Review the code in Verify or Files. Choose one file or all files, Unified / Split diffs, or Full file › Version for an exact revision. Viewed records your reading progress; All viewed and Clear apply to every file. Exit returns to where you came from; while your approval waits it reads Finish code review.

What it costs {#cost}

Cost in the task header estimates each step from local logs at verified API prices; for Copilot it shows its recorded AI-credit value, which is not money billed on top. Unknown values show a dash. Amounts stay hidden until you open it. Usage history opens Settings › Usage.

Agent runs {#agent-runs}

When you start a task or the build, choose where the agent runs:

Recommended. Pick the agent, model, effort and branch. You answer in **Conversation**. Your terminal, IDE or agent app. Ask it in your own words, or copy the prepared prompt. It asks in its own chat; you can still approve a ready Plan and the finished change in the App.

Closing the sidebar keeps the run. The agent's menu has Interrupt (Esc), Stop session and Move to my own agent…; Resume returns.

Conversation folds finished turns to one line; Terminal shows the agent's own program. Below the message box sit activity, model, effort, permissions, pacing and context; each opens its own details. Paste or drop files in either view.

Messages while working steers your agent at its next step where it supports that, and otherwise queues without interrupting. Choose Queue until the turn ends to wait instead. Thinking can be hidden, collapsed or expanded under Agent controls › Appearance….

Stop, archive or delete a task {#stop-archive-or-delete-a-task}

How What stays
Stop Tell your agent The documents
Archive The task header (More on compact screens); Restore undoes it Everything
Delete Confirm Delete for good in the task header Task documents and local records are removed; the code and branch stay

A task from the earlier seven-step workflow cannot be continued or approved. It stays in the task list marked earlier workflow, and Files opens its documents.

In Claude Code {#in-claude-code}

A band above your prompt says when this task or another one needs you; /task-pane adds the steps, build progress and every task that needs you, runs or has an open pull request.

<NextSteps items={[ { title: "Your first task", href: "/docs/first-task", text: "Plan, build and review one small change." }, { title: "Artifacts", href: "/docs/artifacts", text: "The diagrams and clickable screens your agent draws." }, { title: "Settings", href: "/docs/reference/settings", text: "Workflow, agents, memory and usage." }, ]} />