VibeFuse · Workspace
Workspace — sessions, rail, widgets & themes
The VibeFuse window is a free-form widget canvas. The title bar holds File / Agent / Voice, the Beta version, and the Settings gear. Session tabs keep named layouts alive. The left rail is Agents, Widgets, and Skills. Jarvis is the canvas chat — not a separate product name.
Title bar
Drag the title bar to move the window. Left side is the mark plus menus. Right side is update, version, Settings, then minimize / maximize / close.
| Control | What it is |
|---|---|
| File / Agent / Voice | Application menus (details below) |
| Update badge | Appears when a newer build is available — opens Settings → Updates |
| Beta version | Badge reads Beta v{version} — pre-1.0; same number as Settings → About |
| Settings gear | Opens the 14-tab Settings dialog |
File
| Item | What it does |
|---|---|
| New Canvas Session | Creates a named empty session (default name Session N) |
| Open Recent Canvas Session | Flyout of archived sessions — open, closed, or saved — with widget count and last-saved time |
| Settings | Same dialog as the title-bar gear |
Agent
Quick switches for the model Jarvis (canvas chat) and voice use. Full keys and CLI install stay in Settings → Agent.
| Item | What it does |
|---|---|
| Provider | Flyout of the 15 LLM providers (OpenAI, Anthropic, Kimi, Z.ai, Ollama (Local), Ollama Cloud, NVIDIA NIM, Featherless, Google Gemini, X.ai, Together AI, OpenRouter, Plugsky, DeepSeek, Custom) |
| Model | Models for the selected provider — remote list when the API supports it |
| System prompt | Edit the shared assistant instructions appended to Jarvis, voice, and summaries |
| Agent Memory | Edit C:\vibefuse\MEMORY.md — lasting facts Jarvis injects into the system prompt |
Voice
Mode flyout — the same three modes as the voice dock under the record orb.
| Mode | Hint in the menu |
|---|---|
| Normal | Hold to speak · optional wake word |
| Transcription | Hold to record · paste into last clicked widget |
| Note-Taking | Click to record · summarize · upload |
Wake word, devices, and chips: /docs/voice.
Session tabs
A session is a named canvas: widget layouts, sizes, z-order, zoom, pan, and per-session browser audio mute. Inactive canvases stay mounted and hidden so terminals do not reset. Tabs persist in C:\vibefuse\sessions.json.
| Action | How |
|---|---|
| New session | + on the tab strip, or File → New Canvas Session |
| Rename | Tab menu (… or right-click) → Rename |
| Clone session | Tab menu → Clone session — copies layouts with new instance IDs (fresh PTYs) |
| Mute session browser audio | Speaker button on the tab — mutes Browser / YouTube audio for that session only |
| Close session | × then confirm. Last session close creates a new empty one |
| Cycle sessions | Ctrl+Tab while the canvas has focus (two or more sessions) |
C:\vibefuse.Left rail
Three system sections. Collapse the rail; that preference is saved. Bottom of the rail: Style Packs plus the voice record orb. Edit visibility in Settings → Navigation.
| Section | Default items |
|---|---|
| Agents | Jarvis (canvas chat), Hermes Agent, then CLI agents if they are installed |
| Widgets | Split into Built-in / Custom. Defaults: Terminal, Browser, YouTube, HyperFrames, Video, Code Studio, Marketplace |
| Skills | Every local and marketplace SKILL.md package that is not hidden |
Files exists in the catalog and can be shown from Settings → Navigation or Settings → Widgets, but it is not on the default rail.
- Click an agent or widget to spawn it. Only installed CLIs appear under Agents.
- Marketplace under Widgets opens the live catalog in a themed webview.
- Click a skill to load it into Jarvis with
execute_skill. - Saved pages and marketplace iframes land under Widgets → Custom.
Canvas chrome
The stage is a free-form plane. Widgets do not snap to a grid unless you tidy them. These controls sit on the canvas header — they change the camera, not widget files.
| Control | What it does |
|---|---|
| Zoom | Percent control; Ctrl++ / − / 0 and Ctrl+wheel also zoom |
| Fit all widgets | Zoom and pan so every visible widget fits in view. Does not move or resize widgets |
| Zoom canvas to 35% and center | Fixed 35% camera zoom, centered on current widget bounds — overview without changing layouts |
| Tidy widgets | Click again to cycle grid / wide / tall / focus. Zoom adjusts so chrome stays usable |
Widget chrome
Every canvas window has a header you drag to move the widget. Resize from any edge (minimum about 280×180).
| Header | Action |
|---|---|
| Title (double-click or menu) | Rename the instance |
| Reload {name} | Reload that widget (Studio and projects for Code Studio) |
| Fill current view | Expand to the visible canvas; click again to restore size |
| Close | Remove the instance from this session |
| Context menu | Action |
|---|---|
| Refresh widget | Soft-reload the iframe / webview / PTY surface |
| Rename widget | Same as header rename |
| Move forward / Move backward | Change z-order on the canvas |
Widget catalog
Built-ins, CLI agents, saved pages, and marketplace iframes. Spawn from the rail or ask Jarvis to open one.
| Widget | Anchor | Kind |
|---|---|---|
| Terminal | #widget-terminal | Built-in PTY |
| Browser | #widget-browser | Built-in webview |
| YouTube | #widget-youtube | Built-in webview |
| Files | #widget-files | Built-in explorer — not on the default rail |
| Jarvis | #widget-jarvis | Canvas chat (Agents rail) |
| HyperFrames | #widget-hyperframes | Local Studio webview |
| CLI widgets | — | Claude, Codex, Gemini, Cursor, Qwen, and others once installed |
| Video | — | Local file player (often a HyperFrames render) |
| Code Studio | — | In-canvas editor; GitHub token in Settings → Widgets |
| Hermes Agent | — | Loads the Hermes URL from Settings → Agent (default http://localhost:8787) |
| Saved pages | — | Bookmarks from Browser → Save Current Page as New Widget |
| Marketplace iframes | — | widget:// packages from C:\vibefuse\widgets |
Terminal
System PowerShell / pwsh / cmd as a widget. No extra install. Default working directory comes from Settings → General; a session can override it. Scrollback and cwd persist across restarts. Hide / Show the rail item in Settings → Widgets — Terminal is not on the Agent tab.
Browser
Embedded Chromium with back / forward / reload, URL bar, zoom, and Save Current Page as New Widget. URL and zoom persist on that instance. Browser and YouTube share one browser session partition.
Save Current Page as New Widget writes a saved-page package that appears under Widgets → Custom — no address bar on the spawned copy, so it behaves like a pinned site.
YouTube
A focused YouTube viewer that loads youtube.com with minimal chrome: page zoom only (no URL bar). Widget header still offers fill-view and close. Session mute on the tab silences this widget’s audio.
Files
Workspace explorer with previews for images, video, audio, and PDFs. Open a file in its default app or reveal it in Explorer. Starting folder follows the session workspace path (or your home folder). The widget exists; it is not on the default rail until you Show it in Navigation or Widgets settings.
Jarvis
Jarvis is the canvas chat. It uses the Settings → Agent provider and the shared system prompt plus C:\vibefuse\MEMORY.md. Replies render as GitHub-flavored Markdown. Each Jarvis instance keeps its own message memory.
- Canvas tools: add / arrange / close widgets, read and type into terminals, navigate browsers, search, HyperFrames compose/render, skills, memory, subagents.
- Paste images with Ctrl+V — vision models receive the screenshot.
- Tool catalog: Jarvis tools.
HyperFrames
Local HyperFrames Studio in a canvas webview. Workspace C:\vibefuse\hyperframes, preview typically on http://127.0.0.1:4567. Start / Restart / Stop from Settings → Local Servers, or Open widget from that tab. Jarvis tools include hyperframes_compose, hyperframes_init, and hyperframes_render. Requires Node.js 20+ on PATH.
Studio walkthrough: /docs/hyperframes. Video widgets play the rendered MP4.
Themes
Nine built-in presets in Settings → Appearance. Accent color and Reduce motion sit on the same tab. Styling packs from C:\vibefuse\styling can replace tokens and the record orb.
| # | Theme |
|---|---|
| 1 | Midnight Navy |
| 2 | Maroon & Gold |
| 3 | Obsidian |
| 4 | Blood Ember |
| 5 | Toxic Void |
| 6 | Arctic Blade |
| 7 | Copper Wraith |
| 8 | Neon Noir |
| 9 | Porcelain Light |
Shortcuts
| Keys | Action |
|---|---|
| Ctrl+Tab | Cycle session tabs (canvas focused, two or more sessions) |
| Ctrl++ / − / 0 | Zoom in, zoom out, reset to 100% |
| Ctrl+wheel | Zoom around the pointer |
| Alt+drag | Pan empty canvas (middle-click drag also pans) |
| Escape | Close Settings, menus, and dialogs |
| Fn hold | Hold Fn (~1.5s) to start voice the same way as the record orb |
| Ctrl+V | Paste images into Jarvis |
In-app updates
VibeFuse checks fuseintelligence.org for a newer build and offers the installer from inside the window.
| Surface | What you do |
|---|---|
| Title-bar Update badge | Appears when an update is available; opens Settings → Updates |
| Settings → Updates | What's-new feed and featured bubbles |
| Settings → About | Check again / Update / Open downloads page — Update downloads the installer, swaps the exe, and relaunches |