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 Sanguis source, press F5, and Marrow runs it through the compiler and the grid. On a .netlist file, F5 starts the GPU heartbeat; F5 again closes it. 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
Interface
Marrow has four panels arranged in a single window:
| Panel | Description |
|---|---|
| Editor | Syntax-highlighted code editor for Sanguis files. Supports tabs, find, undo/redo. |
| File tree | Browse, open, create, and delete files. Press F2 to toggle. |
| Scope | Shows memory state and output from the last run. Press F3 to toggle. |
| Runtime | Displays organ 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 .sanguis file
2. Compile it through the Sanguis-written compiler
3. Pour the result into the grid and settle it
4. Read the outputs and display them
The compiler that reads your source is written in Sanguis, and the artifact it produces runs on the engine. Running from Marrow uses the same pipeline as the command line.
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 (step-through 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 organs, cells, fields, conditions, 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.