Cagire/docs/getting-started/navigation.md

Navigation

The first thing you need to know is how to navigate in the application. Cagire's interface is organized as a 3x2 grid. There are six views in total:

Dict     Patterns     Options
Help     Sequencer    Engine

• Dict : Forth dictionary — learn about the language.
• Help : Help and tutorials — learn about the tool.
• Patterns : Manage your current session / project.
• Sequencer : The main view, where you edit sequences and play music.
• Options : Configuration settings for the application.
• Engine : Configuration settings for the audio engine.

Switching Views

Use Ctrl+Arrow keys to move between views. A minimap will briefly appear to show your position in the grid. You can also click at the bottom left on the view name to open the switch view panel.

• Ctrl+Left / Ctrl+Right — move horizontally (wraps around)
• Ctrl+Up / Ctrl+Down — move vertically (does not wrap)
• Click at bottom left — select a view

You can also jump directly to any view with F-keys:

Key	View
F1	Dict
F2	Patterns
F3	Options
F4	Help
F5	Sequencer
F6	Engine

Common Keys

These shortcuts work on every view:

Key	Action
Space	Toggle play / stop
q	Quit
s	Save project
l	Load project
?	Show keybindings for view

Getting Help

Press ? on any view to see the associated keybindings. This shows all available shortcuts for the current context. The most important keybindings are displayed in the footer bar. Press Esc to close the keybindings panel.