Using Moru
Keyboard shortcuts
The command menu, and the keys that move around Moru without the mouse.
Press ? on any page to see the shortcuts that work there. Press ⌘K on macOS, or Ctrl+K elsewhere, to open the command menu.
The command menu#
The command menu searches and jumps. Open it with ⌘K / Ctrl+K, or click Search or jump to… in the header. The shortcut works even while you’re typing in a field. Press it again, or Escape, to close the menu.
Type to filter; the matching is fuzzy, so tmtbl finds acme/timetable. The menu lists, in order:
- Actions: what you can do on this page. Inside a repository where you have write access, that includes New request and Propose a change. Shortcuts a page offers as commands appear here too, such as Go to file on code pages and Previous revision / Next revision on a change page. Keyboard shortcuts is always there.
- Changes and Requests: inside a repository, once you’ve typed two characters, the changes and requests whose title or ID matches, up to five of each.
- In acme/timetable: the repository’s sections (Overview, Requests, Changes, CI, Code, Commits, Settings).
- Repositories: the repositories you can see.
- Go to: Home, Docs, Inbox, Account settings, your organizations, New organization, Runners and Sign out. Site admins also get People and GitHub connections.
- Docs: once you type something, up to five pages of this documentation that match.
Use the arrow keys to move and Enter to run the highlighted entry.
Shortcuts#
Letters are lowercase. Two keys separated by “then” are a sequence: press g, let go, then press the second key within a second and a half.
Single-key shortcuts don’t fire while you’re typing in a text field or while a dialog is open, so they never get in the way of what you type. Only ⌘K / Ctrl+K works everywhere.
General#
| Keys | Action |
|---|---|
⌘K / Ctrl+K | Open or close the command menu |
? | Show the keyboard shortcuts for this page |
g then h | Home |
g then i | Inbox (when signed in) |
Repository#
Inside a repository:
| Keys | Action |
|---|---|
g then o | Overview |
g then r | Requests |
g then x | Changes |
g then k | CI |
g then c | Code |
g then m | Commits |
g then s | Settings (when signed in) |
Lists#
On pages with a list of rows, such as Changes, Requests and the Inbox:
| Keys | Action |
|---|---|
j | Next row |
k | Previous row |
o | Open the selected row |
/ | Focus the list’s search box |
Code#
| Keys | Action |
|---|---|
t | Go to file: find a file in the repository by name |
Change#
On a change page:
| Keys | Action |
|---|---|
[ | Previous revision |
] | Next revision |
Keys in forms#
A few keys work inside particular fields rather than across the page:
- In a comment box,
⌘Enter/Ctrl+Entersends the comment. Escape closes the box and keeps your draft in this browser; Cancel discards it. - In Acceptance criteria on a request form, Enter adds the next criterion instead of submitting the form.
- In a list’s search box, Enter searches right away instead of waiting for you to stop typing.
- In the file tree on the Code tab, the up and down arrows move between entries, right opens a folder, left closes it or moves to its parent, and Home and End jump to the first and last entry.
- In Who should do this?, the arrow keys move between Single agent, Bake-off and Assign a human.