| Control |
Behavior |
| Tab 1 through Tab 4 |
Select one of four fixed notebook stores. Selecting a stopped, previously unvisited tab starts its kernel lazily. |
Tab selection also exits the frontend command-mode flag.
| Control |
Enabled state |
Behavior and side effects |
| Kernel-state pill |
Always visible |
Displays the frontend coordinator’s current starting, idle, busy, stopped, or error value. |
| Clear |
Disabled while a lifecycle change is starting |
Stops the active kernel, replaces its cells with one empty cell, resets counter and focus state, and leaves the tab stopped. No confirmation. |
| Run All |
Disabled while stopped, starting, busy, or error |
Sequentially executes every nonempty cell present when the click begins and stops on the first error or cancellation. |
| ↻ Restart |
Disabled while a lifecycle change is starting |
Kills and respawns the active kernel, clears outputs, sets displayed cell counts to zero, and resets cell states. Requests confirmation when the frontend state is busy. |
| ■ Stop |
Disabled while stopped, starting, or error |
Kills the active kernel and installs a stopped sentinel. Preserves source and current rendered outputs. |
| Control |
State |
Behavior |
| Execution label |
After an execution request |
Displays [N], where N comes from that tab’s monotonically increasing frontend counter. |
| ▶ |
Cell not running |
Runs the cell through the shared execution coordinator. |
| ■ |
Cell running |
Requests a kernel interrupt. A force-kill follows after two seconds only if that execution remains busy. |
The run button is not disabled merely because the frontend toolbar says stopped. The execution path ensures the kernel entry, then the backend rejects work when that entry remains a stopped sentinel.
| Control |
Behavior |
| ↑ |
Swap the cell with the previous cell; no-op at the top. |
| ↓ |
Swap the cell with the following cell; no-op at the bottom. |
| × |
Delete the cell. If it was the only cell, create a fresh replacement. |
| Location |
Visibility |
Behavior |
| Below the final cell |
Always visible |
Append and focus a new cell. |
| Between cells |
Visible while the gap is hovered |
Insert and focus a new cell after the preceding cell. |
- Quit — quits the application. The Rust exit handler kills all tracked kernel subprocesses.
- Settings… — opens or focuses a 520 × 480 settings window.
- Close Window — closes the active window. The release has no documented main-window recreation command.
- Undo
- Redo
- Cut
- Copy
- Paste
- Select All
| Control |
Immediate effect |
Persisted effect |
| Use native glass effects |
Calls the Rust vibrancy command and emits a frontend synchronization event. |
Stored only after Save. |
| Interpreter |
Updates settings-form state only. |
Writes python.interpreter after Save; actual kernel manager changes only after app relaunch. |
| Save |
Serializes the form through save_config. |
Rewrites the complete TOML file with standard comments and formatting. |
The settings window reports load, save, and live-appearance errors inline.
