Marrow Terminal
The editor and runtime that ships with the Sanguis SDK
Marrow is the terminal user interface for Sanguis. It is a built-in code editor, file browser, and runtime panel. You write .sang source, press F5, and Marrow runs it through the C transposer and blood bridge on the GPU. No external editor or build system required.
Marrow ships inside the Sanguis binary. Launch it from the command line:
sanguis tui
Or open a specific file:
sanguis tui examples/hello.sang
Interface
Marrow has four panels arranged in a single window:
| Panel | Description |
|---|---|
| Editor | Syntax-highlighted code editor for .sang files. Supports tabs, find, undo/redo. |
| File tree | Browse, open, create, and delete .sang files. Press F2 to toggle. |
| Scope | Shows memory state and output from the last run. Press F3 to toggle. |
| Runtime | Displays organism output, errors, and diagnostics after a run. |
Pipeline
When you press F5 to run, Marrow executes the same pipeline as the command-line tools:
1. Write source to a temp .sang file
2. Call the C transposer to compile .sang to .vana
3. Call the blood bridge to run the .vana on the GPU
4. Capture stdout and display it in the runtime panel
The Rust parser and engine are not used for normal runs. They remain as a fallback if the SDK binaries are not found.
Note. The awakening sequence (F9) still uses the Rust engine internally. It will switch to the C pipeline when the blood bridge supports tick-by-tick execution.
Keybindings
| Key | Action |
|---|---|
| F1 | Help screen |
| F2 | File tree panel |
| F3 | Scope panel (memory and output) |
| F4 | Organism graph (circuit structure) |
| F5 | Run without saving |
| F6 | New file |
| F7 | Save file |
| F8 | Reset organism (fresh boot) |
| F9 | Awaken (tick-by-tick awareness watch) |
| Tab / Shift+Tab | Next / previous tab |
| Ctrl+N | New tab |
| Ctrl+W | Close tab |
| Ctrl+S | Save file |
| Ctrl+Alt+S | Save and run |
| Ctrl+F | Find / search |
| Ctrl+Z / Ctrl+Y | Undo / redo |
| Ctrl+A | Toggle auto-run |
| Ctrl+C / Ctrl+Q | Quit |
What It Looks Like
Marrow runs in a standard terminal. The layout is a dark-themed split view: editor on the left, runtime output on the right, file tree on the far left, status bar at the bottom.
Organism Graph
Press F4 to see a structural view of your program. The graph shows circuits, holds, routes, conditions, emits, and wires. It parses the source to build this view, so it updates as you type.
Tip. Use F4 to verify your circuit structure before running. If the graph shows an error, the program will not compile.