Command Bar
The Command Bar is a Spotlight/Raycast-style overlay in the web portal that provides instant access to venture data and actions without navigating through tabs.
Activation
| Platform | Shortcut |
|---|---|
| Windows / Linux | Ctrl+/ |
| macOS | Cmd+/ |
| Close | Esc |
| Submit | Enter |
| Navigate | Tab |
Context Strip
When the Command Bar opens, it loads the current venture context and displays a strip at the top:
- Active venture — name and prefix
- Mission count — total and active missions
- Fuel spent — current spend in dollars
- Active missions — up to 5 most recent active missions with identifiers and priorities
Context loading is best-effort and non-blocking — the Command Bar opens immediately even if context is still loading.
Text Commands
Type a keyword and press Enter. The Command Bar recognizes these patterns:
| Input | Action |
|---|---|
fuel, cost, spend | Shows fuel summary — total spent, venture count, active missions |
missions, mission list | Lists up to 5 missions with identifier, priority, and title |
squad, agent, agents | Shows active squad count, Q-table size, and exploration rate |
decision, decisions | Directs to mayros kaneru decisions list for full history |
| Any other text | Acknowledged with a hint to use the CLI for full capabilities |
Quick Actions
The Command Bar provides shortcuts for common operations:
- Create mission — type a mission description to start creation
- Check fuel — type "fuel" for an instant summary
- Route task — describe a task to see which agent would handle it
- List agents — type "agents" for squad status
- Squad status — active squads and Q-learning metrics
- Decisions — recent consensus outcomes
Voice Input
The Command Bar supports voice input via the Web Speech API:
- Click the microphone button (visible when Speech API is available)
- Speak your command
- Transcription auto-fills the input field
- Press Enter or wait for auto-submit
Voice is available in browsers that support SpeechRecognition or webkitSpeechRecognition (Chrome, Edge, Safari). The recognition runs in single-shot mode (continuous: false, interimResults: false) with en-US locale.
Voice States
| State | Indicator |
|---|---|
| Idle | Mic button visible |
| Recording | Mic button active, listening for speech |
| Processing | Input field shows transcribed text |
| Error | Recording stops, mic returns to idle |
Keyboard Navigation
| Key | Action |
|---|---|
Ctrl+/ / Cmd+/ | Open Command Bar |
Esc | Close Command Bar |
Enter | Submit current query |
Tab | Navigate between UI elements |
Architecture
The Command Bar fetches venture data from the Gateway via WebSocket:
ventures.dashboard— for venture context, fuel stats, and mission listskaneru.dashboard— for squad and Q-learning metrics
All requests are non-blocking. If the Gateway is unavailable, the Command Bar still opens but shows limited context.
Next Steps
- Canvas — full venture visualization surfaces
- Setup Wizard — guided venture creation
- Control UI — the web portal that hosts the Command Bar