Lab guide · read before you sign in

The lab, chapter by chapter.

The lab at lab.roroquantum.com is a VS Code-shaped editor with a phone line to real quantum machines. These are the same 14 chapters it shows inside the app — how projects, runs, credits, Python, notebooks, the library and Copilot actually behave — published here so a hackathon organiser, an evaluator or a researcher can read the whole thing first.

14 chapters4 sections47 keyboard bindings, all real1 source of truth — the text inside the lab
Chapters

Fourteen short chapters, in reading order.

Each one is written from what the lab actually does — nothing aspirational. Chapters cross-link, and the last section is playbooks: read the one written for you.

Start here1 chapter
Working in the lab7 chapters
Reference3 chapters
Playbooks3 chapters
The 60-second tour

Six things on screen.

The tour the lab offers on first visit, as text: Your project · Tabs · The Run rail · Output · Library · Copilot. That is the whole surface.

01

Your project

Files live here. Click to open, right-click for new / rename / delete; a slash in a file name makes a folder. Everything autosaves.

02

Tabs

Every open file is a tab — drag to reorder, middle-click to close. A .qasm tab gets a Code | Circuit toggle; a .py tab gets ▶ Run file.

03

The Run rail

Follows the active file. A .qasm gets circuit, machine, shots and a server-priced quote; real hardware asks before it holds credits.

04

Output

Program output and run stories land here — a timeline, a histogram and one honest line about credits. Explain this result asks Copilot. ⌘J hides it.

05

Library

48 worked programs on five shelves — start with these, business cases, applications, algorithms, building blocks. ⌘K searches by subject; Fork makes one yours.

06

Copilot

Reads your project, proposes edits behind approval cards, runs Python locally. Metered per turn, no per-message cap — every cost lands in the feed as it settles, and it cannot spend run credits.

Keyboard

Everything has a key.

The bindings that work everywhere in the lab. The full list — editor, notebook, circuit builder, explorer, gallery, Copilot — is one page.

macOSWindows / LinuxWhat it does
⌘⇧P or ⌘PCtrl+Shift+P or Ctrl+PCommand palette — commands, files, library items, guide chapters
⌘KCtrl+KSearch the library by subject (or focus the gallery's search)
⌘⇧FCtrl+Shift+FFind and replace across the project
⌘⇧MCtrl+Shift+MProblems — the syntax check for this project
⌘OCtrl+OSwitch project
⌘JCtrl+JShow / hide the bottom panel
⌘SCtrl+SSave all now (autosave runs 1.2 s after you stop typing)
⌘/Ctrl+/This cheatsheet (outside the text editor — inside, it toggles a comment)
EscEscClose the palette, a dialog, the gallery or the tour

47 bindings, by surface

Every entry is a real binding in the lab — nothing listed here is planned. The same list opens as an overlay inside the lab with ⌘/ (Ctrl+/ on Windows / Linux).

All keyboard shortcuts

Read enough?

Open the lab, or read the API docs.

The lab is where you prototype and read the catalogue; the SDKs and the REST API are where an integration lives. Same run engine, same credits, same machine codenames everywhere.