Runic
AUTOCOMPLETE

It knows your commands and your document names

Type a dot for the command menu, .do for your documents, .back for the steps in this document, an actor’s first letters in a sequence diagram.

Try it free →Read the docs

What it is

The language has ten commands and the editor never makes you remember them. Type . at the start of a line and a menu lists every command with a one-line description; keep typing to filter. The same menu becomes a name completer when a command needs a target. The menu itself — placement, scaffolds, keys — has its own page; this one is about what it offers to complete.

Document names after .go and .do

After .go or .do , with nothing else on the line after the caret, the menu switches to your documents of both kinds except the one you are in: substring match on what you typed, prefix matches first, then alphabetical, up to eight rows. Each row shows the name and “N lines”, or “sequence · N lines” for a sequence diagram. Once the target exactly matches a document name, case-insensitive, the menu closes so Enter opens a new line as usual. Picking a row rewrites the line to .go <name> or .do <name>.

The sequence editor has the same completion: after .do or .go it lists the other documents with a “Process” or “Sequence diagram” label, and stops offering once you type a “: ” caption.

Steps after .back

After .back it lists the plain steps and .input lines of the current document, captions stripped, deduplicated case-insensitively, the caret’s own line excluded, in document order and capped at eight. Each row reads “line N · above” or “line N · below”, because a return arrow can point either way. The menu closes once the text equals a candidate exactly; picking one rewrites the line to .back <step text>.

Actors in a sequence diagram

At the start of a line, one or more letters matching a known actor list up to eight actors with “Message from this actor”; picking one appends “ -> ”. After an arrow (->, -->, ->>, with or without +/-), the partial receiver lists actors with “Send to this actor”; picking one appends “: ”.

Ghost suggestions

Signed in, in a process document, a second completion appears: 700 ms after your last keystroke or caret move, if the caret sits at the end of a line, there is text above it, and no menu, AI bar, drag or fold is active, Runic asks the AI for one line and shows it gray at the caret with a “TAB” chip. Tab accepts it; Esc or any keystroke dismisses it; a reply that arrives after you moved on is dropped. The “✦ Suggest on/off” chip in the footer turns it off and remembers the choice with Preferences consent. Tab prefers a visible ghost over indenting. Errors never surface. The sequence editor has no ghost.

How to use it

  1. Open the command menu
    At the start of a line type .. The “Commands” menu lists each command with its description. Keep typing to filter, for example .i leaves .if and .input.
  2. Pick one
    Use ↑ and ↓ to move, then Enter or Tab to insert. The footer reminds you: “↑↓ navigate · ↵ insert · esc dismiss”.
  3. Complete a document name
    Type .do and the menu switches to your other documents, sequence diagrams marked “sequence ·”. Type part of a name to filter; Enter inserts the exact name.
  4. Complete a .back target
    Type .back and the menu lists this document’s steps with their line numbers and whether they sit above or below the caret.
  5. Complete an actor
    In a sequence diagram, type the first letters of an actor at the start of a line and pick it; Runic appends “ -> ”. After the arrow, pick the receiver and it appends “: ”.
  6. Dismiss
    Press Esc. The menu stays away until you change what you typed, then offers again.

Commands & shortcuts

.At line start: open the Commands menu
↑ / ↓Move the highlight (wraps at both ends)
Enter / TabInsert the highlighted item
EscDismiss for the current prefix
.go / .doThen a space: your other documents of both kinds, up to 8, “sequence ·” marks a diagram
.backThen a space: this document’s steps and .input lines, up to 8, “line N · above/below”
Actor letters · after an arrowSequence editor: “Message from this actor” · “Send to this actor”
TabAccept a gray ghost suggestion (signed in, process documents)
✦ Suggest on/offFooter chip that disables ghost suggestions

Tips

  • Pressing Enter on a bare . without moving the highlight closes the menu and opens a new line instead of inserting .if; keep typing after the dot when you want a command by hand.
  • Pick .if from the menu to get both branches scaffolded. Pressing Enter at the end of a typed .if line does the same.
  • The .do list shows how many non-empty lines each document has, so an empty stub reads “0 lines”.
  • A bare ⌘, Ctrl, Alt or Shift press leaves the menu where it is, so a screenshot chord like ⌘⇧4 does not lose your place; a real combination such as ⌘+Down closes the menu and does what it normally does.

Questions

Why does the document menu not show the document I am in?

A document calling itself is rarely what you want, so the current one is excluded. Use .back for loops inside a process.

Why did the menu close while I was typing a name?

Your text now matches a document exactly, so there is nothing left to suggest. Enter opens a new line.

Does the menu need the AI?

No. Command, document, step and actor completion run locally in the editor. Only the gray ghost suggestions call the AI, so they need a signed-in account and a process document.