VibeFuse Documentation — Free AI Agent Harness for Windows

VibeFuse is a free Windows AI agent harness: run Claude Code, Codex, Gemini, Cursor, and Qwen as canvas widgets with local Whisper + Piper, MCP tools, HyperFrames video, Skill Seekers, and a marketplace where you can sell skills and widgets. This guide covers the Windows 10+ installer, complimentary VF- license, in-app updates, every built-in widget (Terminal, Browser, YouTube, Files, Vibe Agent, HyperFrames Studio, Video, agent CLIs, saved pages, marketplace widget:// iframes), the Skills rail, paid and free Agent Skills marketplace, Vibe Agent create_skill / update_skill, MCP tools (Google Workspace & Drive, GitHub, Copilot, Discord, Linear, custom stdio), Local Servers (Piper, Whisper, HyperFrames, Skill Seekers, Crawl4AI + SearXNG), OpenRouter and Plugsky providers, Jarvis wake word + Notes mode, named sessions, navigation editor, nine themes, Stripe Connect seller payouts, and 14-tab Settings.

v0.1.23 Free forever Windows 10+ x64 Widget canvas Widgets + Skills Workspace MCP Drive MCP 14-tab Settings Local Servers HyperFrames Skill Seekers Sell skills Live UI clones
Product tour of the VibeFuse canvas: terminals, agents, voice dock, Local Servers, and marketplace sync.

What's new in v0.1.23

  • Local Servers tab — fourteenth Settings tab for Piper endpoint / voice / speed / volume, Whisper endpoint + model picker, HyperFrames Studio start/stop, Skill Seekers Connect, and Crawl4AI + SearXNG endpoints.
  • HyperFrames Studio — HTML-to-video composer on the canvas at http://127.0.0.1:4567. Workspace C:\vibefuse\hyperframes. Vibe Agent can compose, check, preview, and render MP4s, then spawn a Video widget.
  • Skill Seekers — local Python MCP cloned to C:\vibefuse\Skill_Seekers. Search docs-to-skill presets (React, Godot, Blender, Claude Code, Unity, …) before writing a new skill. No API key.
  • Paid marketplace — price widgets and skills ($0.50–$500). Connect Stripe in Account → Stripe Connect; sellers keep 80%, Fuse Intelligence takes a 20% platform fee.
  • GitHub, Copilot, Discord, Linear MCP — branded Tools cards alongside Google Workspace / Drive, plus HyperFrames, Skill Seekers, and Crawl4AI + SearXNG.
  • Quieter voice replies — Piper speaks a short start cue when tools begin, then one spoken final answer. No TTS between tool calls.
  • Linear widget — issue and project queries stay under Linear’s GraphQL complexity cap so the widget loads instead of failing.
  • Browser tabs — click tabs to switch pages even when the canvas is zoomed or panned. The agent can jump to an already-open URL instead of fighting the live page.
  • GitHub, Discord, and Linear MCP — list GitHub repos through the saved PAT, Discord default guild + snowflake IDs, plus Linear tools (from v0.1.10).
  • VibeFuse Skills marketplace — browse and save skill packages on /marketplace. They sync into C:\vibefuse\skills and appear in the Skills rail. Publish from Account → Marketplace Settings.
  • Vibe Agent creates and edits skills — ask the canvas chat to write a skill and it calls create_skill, update_skill, delete_skill, execute_skill, read_skill, and read_skill_file. The Skills section and Settings → Skills refresh immediately.
  • Widget marketplace is live — browse VibeFuse widgets on the web, save to your library, and they sync into the desktop canvas automatically. Publish your own widgets from a local folder in Settings → Marketplace.
  • Vibe Agent widget — a dedicated chat assistant on the canvas. It shares the voice assistant's tools: it can create, arrange, read, and remove widgets, type into terminals, drive browsers, web-search via local SearXNG, call MCP tools, create/edit skills, and speak short replies.
  • Files widget — browse the session workspace with previews for images, video, audio, and PDFs; open or reveal in Explorer.
  • Local voice engines — Whisper (whisper-cli.exe) and Piper (piper.exe) now run on-device under %LOCALAPPDATA%\VibeFuse\bin with the Jarvis voice; remote voice hosts become the fallback.
  • Jarvis wake word — enable it in Settings → Voice and say “Jarvis”; VibeFuse plays a short “Yes, sir?” and takes your command hands-free.
  • Voice notes mode — switch the dock to Notes, click to record, and VibeFuse summarizes the take into bullets and uploads it to your profile (Account → Notes).
  • MCP Tools tab — two Google cards ship built in: Google Workspace (Gmail, Drive, Calendar, Docs, Sheets, Tasks, Slides, Meet, Contacts — ~24 tools) and Google Drive (read-only Drive MCP — ~3 tools). Same OAuth client, Connect / Sign in with Google / Use saved Google account, plus any custom stdio server.
  • Provider grid — Settings → Agent now includes OpenAI, Ollama Local, Ollama Cloud, NVIDIA NIM, Featherless, Google Gemini, Groq, Together AI, OpenRouter, Plugsky, and Custom. Each card keeps its own key, endpoint, and model.
  • In-app updates — Settings → Updates shows the release feed; Settings → About → Check for updates downloads and runs the installer update for you.
  • Navigation editor — rename, reorder, and hide left-rail items; create your own categories (Settings → Navigation).
  • Themes & polish — nine theme presets (Midnight Navy, Maroon & Gold, Obsidian, Blood Ember, Toxic Void, Arctic Blade, Copper Wraith, Neon Noir, Porcelain Light), per-session audio mute, voice history, and workspace state saved on close.
Re-download VibeFuseInstaller.exe or VibeFuse.exe from /downloads/VibeFuse/ to get v0.1.23 — or use Settings → About → Check for updates inside the app.
1 · Account

Register or sign in. VibeFuse is free — a VF- key is written to Product Keys on your profile.

2 · Installer

Download VibeFuseInstaller.exe. It fetches the app exe, voice models, local speech engines, and agent CLIs, then launches VibeFuse.

3 · First canvas

Spawn Terminal, Browser, YouTube, Files, Vibe Agent, or an agent from the left rail. Save a skill from the marketplace — or ask Vibe Agent to write one. Hold the title-bar mic to speak — or say “Jarvis”. Sessions keep every widget live when you switch tabs.

Overview — free widget canvas for the agent harness

VibeFuse (VibeFuse.exe) is Fuse Intelligence’s Windows AI agent harness for Windows 10+ x64. Agents, a system terminal, embedded browsers, a file explorer, and Vibe Agent chat each spawn as draggable widgets on a free-form React canvas. Voice is built in: hold-to-talk local Whisper STT, Jarvis wake word with Piper “Yes, sir?” ack, Notes mode, and near-real-time Jarvis TTS replies. Local Servers host Piper, Whisper, HyperFrames Studio, Skill Seekers, and Crawl4AI + SearXNG on your PC. The marketplace lets you sell widgets and SKILL.md packages through Stripe Connect.

  • Free: every Fuse Intelligence account receives a profile-linked VF- key with no checkout
  • Widgets: Terminal, Browser, YouTube, Files, Vibe Agent, Claude, Codex, Gemini, Cursor, Qwen, saved pages, and marketplace iframe widgets
  • Skills: Claude/Codex-compatible SKILL.md packages in C:\vibefuse\skills — local folders, marketplace saves, and skills Vibe Agent writes for you
  • Sessions: named canvases you can create, rename, clone, mute, and close without killing live PTYs
  • Voice: hold-to-talk with local Whisper, Jarvis wake word, notes mode, and on-device Piper replies
  • Tools: canvas-controlling assistant tools, skill CRUD tools, plus MCP servers (Google Workspace / Drive presets and custom stdio servers)
  • Local Servers: Piper TTS, Whisper STT, HyperFrames Studio, Skill Seekers MCP, Crawl4AI scrape, and SearXNG search — all on-device
  • Marketplace: live at /marketplace — browse, buy, save, sync, and sell widgets and Agent Skills (80% seller payout)

App shell — title bar, rail, sessions, canvas, and voice dock

UI catalog — live desktop clones

Every showcase below is the same HTML/CSS as the VibeFuse desktop app: shell chrome, settings tabs, widgets, and overlays. Browse the full set (search + theme switcher) in the standalone component catalog.

Title bar

Nine theme presets

Architecture

VibeFuse is a Windows desktop app. The main process owns PTY sessions, CLI and MCP management, local speech, marketplace sync, notes sync, in-app updates, IPC, and local persistence in C:\vibefuse\. The renderer is a React widget canvas with live terminals, embedded browsers, a file explorer, Vibe Agent chat, the Skills rail, the voice dock, and the thirteen-tab Settings modal. Licensing, version checks, marketplace, notes, and the update feed go through Fuse Intelligence; agent CLIs and voice engines run locally.

VibeFuse architecture: installer and Fuse Intelligence web services connect to the desktop main process with PTY and IPC, which bridges to the React renderer canvas, agent CLIs, local voice engines, MCP servers, and marketplace widgets
Main process ↔ renderer bridge, live PTY widgets, local voice pipeline, MCP servers, and marketplace packages.

Status bar — local services

LayerResponsibility
InstallerVerifies your VF- key, downloads VibeFuse.exe, caches the Whisper model and Jarvis Piper voice, installs local speech engines and missing agent CLIs
Main processnode-pty shells, CLI install/uninstall, MCP stdio servers, Google Workspace / Drive OAuth, marketplace widget + skill sync/publish, notes sync, app updates, file explorer IPC, and state in C:\vibefuse\vibefuse.json
PreloadExposes window.vibefuse to the renderer — PTY spawn/write/resize, settings, widgets, skills, marketplace, notes, voice, MCP, FS, and update APIs
RendererSession tabs, draggable canvas, xterm terminals, Chromium browser widgets, Files explorer, Vibe Agent chat, Skills rail, voice dock, thirteen-tab Settings modal
Agent CLIsOne PTY per widget — Terminal, Claude, Codex, Gemini, Cursor, Qwen — with session restore for cwd and scrollback; only installed agents appear in the rail
SkillsLocal packages in C:\vibefuse\skills\<name>\SKILL.md. Marketplace saves and Vibe Agent create_skill write the same folder. Hide in Settings → Skills without deleting.
VoiceLocal-first Whisper STT (whisper-cli.exe + selectable ggml models) and Piper TTS (Jarvis / Lewis / Michael / Adam / Heart / Bella / Emma) with remote hosts as fallback; Jarvis wake word
Local ServersPiper on 127.0.0.1:4123, Whisper on 127.0.0.1:8935, HyperFrames Studio on 127.0.0.1:4567, Skill Seekers MCP at C:\vibefuse\Skill_Seekers, Crawl4AI on 127.0.0.1:11235, SearXNG on 127.0.0.1:51452
MarketplaceHosted catalog at /marketplace — free and paid widgets + Agent Skills, Stripe Connect checkout, library sync, publish/unpublish, trending pulse; iframe widgets load through widget://

Requirements

ComponentMinimumRecommended
OSWindows 10/11 64-bitLatest Windows 11
CPU / RAM4-core · 8 GB8+ cores · 16 GB with several agent widgets
Disk~400 MB for the appSSD; extra space for Whisper / Piper models, speech engines, and agent CLIs
Node.jsInstalled by the VibeFuse installer (winget) if missingCurrent LTS on PATH
ffmpegOn PATH for local transcription (microphone audio conversion)Recent static build on PATH
NetworkHTTPS to fuseintelligence.org for the app download, marketplace sync, notes, and update checksAlso useful for remote voice hosts and your chat provider
MicrophoneRequired for hold-to-talk and the wake wordGrant Windows Privacy → Microphone to VibeFuse

Installer

VibeFuseInstaller.exe is a styled navy / steel / gold bootstrap (~90 KB). It reads the live version, downloads the desktop exe from /downloads/VibeFuse/, then installs anything missing before launch.

  1. Open Downloads or Account → Downloads.
  2. Copy your complimentary VF- key from Account → Product Keys.
  3. Run VibeFuseInstaller.exe, paste the key, then approve the elevation prompt. Install will not start until the key verifies against your profile.
  4. The installer reads version.json, then /api/app-version.php?product=vibefuse if needed.
  5. It saves VibeFuse.exe under Program Files\VibeFuse (elevated) or %LOCALAPPDATA%\Programs\VibeFuse, and writes your verified license beside the exe.
  6. Missing pieces are installed only if absent: Node.js LTS and Git via winget; Claude Code, Codex, Gemini, and Qwen via npm; Cursor via PowerShell.
  7. The Whisper model (ggml-base.en-q5_1.bin) and the Jarvis Piper voice (jarvis.onnx) land in %LOCALAPPDATA%\VibeFuse\models\; the local speech engines (whisper-cli.exe, piper.exe) land in %LOCALAPPDATA%\VibeFuse\bin\.
  8. Desktop and Start Menu shortcuts are created, then the app launches.

Updating from inside the app

VibeFuse checks /api/app-version.php?product=vibefuse (falling back to version.json). When a newer build exists, use Settings → About → Check for updates: the app downloads the installer to %TEMP%, runs it with --update --install-dir --license-key so the saved key is reused, closes itself, and the installer swaps the exe and relaunches. The Settings → Updates tab shows the same release feed as /updates/vibefuse.

Setup requires a VF- product key so the desktop install is linked to your Fuse Intelligence profile. Get one free from Account → Product Keys after you create an account. Keep the desktop window — a browser tab on the Vite port is not a real PTY host.

Version

Current release in the database: v0.1.23. The same semver is stored in three places:

SourceWhere
Databaseapp_version.product_slug = vibefuse — Admin → App Versions
Public JSON/downloads/VibeFuse/version.json
API/api/app-version.php?product=vibefuse
Desktop appTitle bar subtitle and Settings → About

License key

VibeFuse is complimentary. On register, login, or Google sign-in the site creates an active free subscription and a unique VF-xxxx-xxxx-xxxx-xxxx key on your user id. Keys do not expire.

Sign in to see the key on this page, or copy it from Product Keys.

The key powers marketplace sync, publishing, and notes sync in the desktop app. It is saved beside VibeFuse.exe by the installer and kept in %APPDATA%\VibeFuse\license.json.

Workspace UI

The window is frameless with a theme-driven look. Drag the title bar to move it. The left rail is organized into three system sections: Agents (Vibe Agent first, then installed CLIs), Widgets (Browser, YouTube, Files, Marketplace action, saved pages, marketplace iframes), and Skills (every local and marketplace SKILL.md package). The canvas is a free-form plane.

ActionHow
Spawn a widgetClick an agent or widget in the left rail — only installed agents are listed
Browse the marketplaceThe Marketplace action under Widgets opens the live site in a themed webview
Run a skillClick a skill in the Skills section — Vibe Agent loads it with execute_skill
Move a widgetDrag the widget header
ResizeDrag any corner or edge handle (minimum about 280×180)
Pan the canvasAlt-drag or middle-click drag empty space
ZoomCtrl+scroll; Ctrl+0 resets to 100%
Cycle sessionsCtrl+Tab while the canvas has focus (two or more sessions)
Mute session audioSpeaker button on the session tab — mutes browser / YouTube audio for that session
Session workspaceSet the folder path in the left rail — saved per session
Collapse the railThe rail collapse control — preference is saved
SettingsGear in the title bar (top-right, beside minimize / maximize / close)

Browser widgets remember URL and zoom in the widget config and share one browser session partition. Saved pages appear under Widgets without an address bar. Skills stay in their own section — hide one in Settings → Skills or Settings → Navigation without deleting the folder. Inactive session canvases stay mounted and hidden so terminals do not reset. Workspace state is flushed to disk when the window closes, so nothing is lost on quit.

App menu bar

Left rail — Agents, Widgets, Skills

Collapsed rail

Nav flyout search

Canvas zoom

Empty canvas

Saving and loading canvas sessions

A session is a named canvas: widget layouts, sizes, z-order, zoom, pan, and per-session audio mute. Use sessions to keep a review layout, a coding layout, and a research layout without tearing down PTYs.

  • + creates a new empty session
  • Click a tab to switch. Hidden canvases keep their terminals alive
  • × closes a session after confirm
  • Tab menu (click or right-click): Rename, Clone
  • Clone copies layouts and config with new instance IDs (fresh PTYs)
  • Each session can store its own workspace path in the left rail for terminal and agent cwd
  • Each session has an audio mute toggle for its browser widgets
  • Ctrl+Tab cycles sessions when the canvas is focused
  • The workspace snapshot is persisted locally (C:\vibefuse\vibefuse.json, migrated from the old %APPDATA% state file) so sessions reload on next launch

Session tabs

Tab menu — Rename, Clone

Close session

Rename dialogs

Workflow preference lives in the session snapshot — which widgets you placed, where they sit, and canvas zoom/pan — not in the product key.

Local speech to text, Jarvis wake word, and Piper speech

The title-bar voice dock is hold-to-talk. Pointer capture stays on the mic button so the take is not aborted mid-hold. Speech is local-first: recording goes to whisper-cli.exe (whisper.cpp, with ffmpeg for audio conversion) on your PC; if the local engine or model is missing, the take falls back to the remote Whisper host. Replies are spoken by piper.exe with the Jarvis voice (jarvis.onnx, British RP) on-device; the remote Piper host is the fallback. Default voice is jarvis at 1.45× speed.

While idle or thinking, only the mic button shows. During recording or Piper playback, a left-side equalizer animates beside the button. After transcription, the You / Assistant transcript panel appears to the right of the record button and fades after a few seconds (hover to keep it open). The dock has a mode picker below the orb — choose Normal Mode (hold-to-talk, with optional wake word) or Note-Taking (click-to-record). See Wake word and Note-Taking mode below.

Voice dock — orb, modes, and transcript

Activity pill

Equalizer

Voice toast

Hold-to-talk button

StateWhat happens
HoldMicrophone capture; equalizer appears to the left of the mic. Title-bar drag is disabled while holding.
ReleaseAudio is transcribed locally first; the remote STT host is used only if local is not ready.
Wake wordSay “Jarvis” (also tolerates “J.A.R.V.I.S”, “Jervis”, …). A “Yes, sir?” ack plays, then your command is recorded. Normal mode only; enable in Settings → Voice.
ThinkingSpinner only — no equalizer until Piper is ready.
SpeakingEqualizer returns while Piper plays. Transcript panel opens to the right of the mic when a reply is ready.

The installer caches the Whisper model, the Jarvis voice, and both speech engines locally when missing; the app re-checks and repairs them on launch. Voice choices, speed, volume, the wake word toggle, and a Test voice probe live in Settings → Voice. Transcripts and replies are kept in Settings → History.

Jarvis wake word

The wake word makes VibeFuse hands-free. Turn it on once in Settings → Voice → Jarvis wake word and the app keeps listening in the background while it is in Normal Mode — no button, no hold.

  1. Enable Jarvis wake word in Settings → Voice (Normal Mode only — the wake listener pauses in Note-Taking mode).
  2. Say “Jarvis” — clearly, in a normal voice. Variants like “J.A.R.V.I.S”, “Jervis”, or “Jarviz” are recognized too.
  3. VibeFuse plays a short cached “Yes, sir?” acknowledgement (Piper, no round-trip) and starts recording your command.
  4. Speak your command, then pause. The take ends on silence and runs the same pipeline as hold-to-talk: transcription → provider reply → Piper speech — and canvas tool calls if the command asks for them.
BehaviorDetail
Adaptive captureThe wake clip flushes as soon as “Jarvis” is heard (roughly 0.4–1.0 s) instead of waiting on a fixed window, so the ack feels instant.
Barge-inWhile Piper is speaking, a new “Jarvis” interrupts the playback and starts a new command session.
Timeout & cooldownIf no command follows within ~12 seconds, wake listening resumes quietly; after a session there is a short cooldown so TTS echoes cannot re-trigger it.
Audio duckingSession browser/YouTube audio is muted during the wake exchange and restored afterwards; in Note-Taking mode nothing is ducked.
Fast transcriptionThe wake path prefers the local tiny Whisper model with a “Jarvis” prompt bias so the trigger word is picked up reliably and quickly.
PrivacyListening, transcription, and speech all run on your PC by default — the remote voice hosts are only a fallback.

Settings → Voice — Jarvis wake word, devices, and test

Wake word not triggering? Keep Normal Mode active, grant the microphone in Windows Privacy settings, and try “Jarvis” again — the equalizer stays quiet until the wake word is heard.

Note-Taking mode

Note-Taking mode turns the voice dock into a one-click dictation recorder: take a note, and VibeFuse transcribes it, summarizes it into bullet points with an auto-generated title, and uploads it to your Fuse Intelligence profile.

Switching modes

Click the mode label under the mic orb (it reads Normal Mode or Note-Taking) and pick from the menu. You cannot switch mid-recording — finish the current take first. The menu summarizes each mode: Hold to speak · optional Jarvis wake word versus Click to record · summarize · upload (wake word paused).

Taking a note

  1. Switch the dock to Note-Taking. Have a provider configured in Settings → Agent — the summary step uses it.
  2. Click the orb to start recording (no holding). The equalizer animates while you talk.
  3. Click again to stop. Very short takes are ignored with a hint to speak longer.
  4. The dock shows Thinking while the take is transcribed locally, then your provider summarizes the transcript into bullets and a title.
  5. The bullets and the full transcript upload to your profile, and the transcript panel confirms: Saved as “…” to your Fuse Intelligence notes.

What gets saved

  • Each click-to-click recording becomes one note: bullet summary first, the full transcript below a divider
  • Notes are grouped into sessions on your profile, so a run of notes reads as one stream
  • If summarization fails (no provider, endpoint error), the raw transcript is still uploaded under a fallback title — nothing is lost
  • Notes sync against your VF- key, so they follow your profile across machines
  • Normal Mode never uploads — Note-Taking is the only path that writes to your profile, and the wake word is paused while it is active

Review everything at Account → Notes on the web, or in Settings → Notes inside the app, where you can browse, edit, and delete notes per session group.

Mode picker — Normal vs Note-Taking

Notes panel

Settings → Notes

Link your own AI provider

Set this in Settings → Agent. The live grid is eleven cards. Each card stores its own API key, endpoint, and model — switching a card restores the last values you used on that provider. Refresh models pulls the remote list when the API supports it; you can also paste a custom model id. Test connection pings the endpoint before you rely on it. The same provider powers Jarvis (voice) and the Vibe Agent chat widget.

Provider grid

Agent CLI install cards

ProviderDefault endpointAuth / notes
OpenAIhttps://api.openai.com/v1Bearer sk-… · gpt-4o-mini, gpt-4o, gpt-4.1-mini
Ollama (Local)http://127.0.0.1:11434/v1No key · lists local tags (llama3.2, qwen2.5, mistral)
Ollama Cloudhttps://ollama.com/v1Bearer Ollama API key · endpoint editable
NVIDIA NIMhttps://integrate.api.nvidia.com/v1Bearer nvapi-…
Featherlesshttps://api.featherless.ai/v1Bearer featherless_… · large hosted open-model catalog
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openaiBearer AIza… · gemini-2.5-flash and friends
Groqhttps://api.groq.com/openai/v1Bearer gsk_…
Together AIhttps://api.together.xyz/v1Bearer together_…
OpenRouterhttps://openrouter.ai/api/v1Bearer sk-or-… · unified gateway (OpenAI, Gemini, Claude, …)
Plugskyhttps://api.plugsky.com/v1Bearer sk-live-… · Plugsky chat, coder, and embed models
CustomYour OpenAI-compatible base URLOptional key · paste any model id

The full Agent tab matches the desktop chrome — provider grid plus CLI install chips:

Settings → Agent

The voice assistant asks the model for JSON:

{ "text": "full on-screen answer", "speech": "short Piper line" }

The dock shows the full text. Piper only speaks speech. The Vibe Agent widget skips the JSON envelope and replies in GitHub-flavored Markdown with tool calls (up to eight rounds per turn). If the endpoint is empty, the raw transcript is spoken through Piper.

MCP tools — Google, GitHub, Copilot, Discord, Linear

Settings → Tools is branded MCP cards plus your custom stdio servers. Google Workspace and Drive share one OAuth client. GitHub uses a PAT; Copilot uses a Copilot-capable token; Discord is a local Java MCP; Linear is hosted OAuth at mcp.linear.app. HyperFrames, Skill Seekers, and Crawl4AI + SearXNG also appear here and are started from Settings → Local Servers. The live pill shows ready · tool count. Jarvis and Vibe Agent call every connected tool the same way they call canvas tools.

MCP connection list

ConnectionWhat you seeWhat the AI gets
Google Workspace Workspace logo, chips for Google account, Gmail, Drive, Calendar, Sheets, Docs, Tasks, Slides, Meet, Contacts. Connect / Disconnect. Sign in with Google, or Use saved Google account after the first login. Enable Workspace APIs link if Cloud APIs are off. ~24 MCP tools — mail, calendar, Drive, Docs, Sheets, Tasks, Slides, Meet, Contacts
Google Drive Drive logo, chips for Google account + Drive. Same OAuth as Workspace. Connect + Sign in. Status: Google Drive MCP connected · 3 tools ready for the AI. ~3 read-focused Drive tools (list / fetch file content)
GitHub GitHub logo, chips for Repos / Issues / Pull requests. Paste a PAT (classic or fine-grained with repo scope). Connect / Disconnect. Status shows tool count when ready. List repos, issues, PRs, and files through the saved token
GitHub Copilot Copilot card for coding agent, reviews, and Spaces. Uses a Copilot-capable token when available. Copilot agent / Spaces tools exposed to Jarvis and Vibe Agent
Discord Local MCP from SaseQ/discord-mcp. Needs Java + the Discord bot token. Set a default guild and optional channel snowflake IDs. Messages, channels, roles, and guild tools for the default server
Linear Hosted MCP at https://mcp.linear.app/mcp with OAuth. Issues stay under Linear’s GraphQL complexity cap so the widget and tools load instead of failing. Issues, projects, and teams — same tools the Linear widget uses
Custom stdio Name field, On checkbox, live state + tool count, Remove, Command, Arguments. Add MCP Connection appends another card. Whatever that server lists — e.g. npx -y @modelcontextprotocol/server-filesystem
  • Enable a server and VibeFuse spawns it, lists its tools, and exposes them to the voice assistant and Vibe Agent as callable functions
  • Servers stop cleanly with the app; the pill updates from connecting → ready / error
  • Google sign-in is a sandboxed OAuth popup; the linked email prints on both cards
  • If Drive/Gmail calls fail with “API has not been used…”, open Enable Workspace APIs for the shared OAuth project, then reconnect
  • Built-in assistant search: web_search uses a local SearXNG endpoint (http://127.0.0.1:51452 by default)

The same Tools panel lives in Settings — Google Workspace, Drive, GitHub, Discord, Linear, and custom stdio:

Settings → Tools

Agent Skills — rail, Settings, and Vibe Agent

A skill is a folder with a Claude/Codex-compatible SKILL.md. VibeFuse loads every package from C:\vibefuse\skills into the left-rail Skills section and into Settings → Skills. Marketplace saves write the same folder. Vibe Agent can create, edit, delete, read, and execute skills without you touching disk.

Settings → Skills

Vibe Agent · create_skill / update_skill

Skill details overlay

Slash commands

What Vibe Agent can do

ToolWhat it does
list_skillsLists installed skills from C:\vibefuse\skills (name, description, slug, author)
create_skillCreates or overwrites a package. Required: name (kebab-case), description. Optional: body (SKILL.md markdown), files (relative paths → contents, e.g. references/guide.md)
update_skillPatches description, SKILL.md body, and/or supporting files. Sidebar + Settings → Skills refresh immediately
delete_skillDeletes the skill folder and removes it from the rail
execute_skillLoads the full SKILL.md and applies it to the current task — also runs when you click a skill in the rail
read_skillReturns the full SKILL.md body (for matching or /skill-name invokes)
read_skill_fileReads a supporting file under the skill folder (references/, scripts/, assets/)
  • Each Settings card shows name, Local or Marketplace badge, version, owner, description, Hide / Show, and Remove (confirm → Delete folder)
  • Hide removes the skill from the rail without deleting the folder — same visibility toggle as Settings → Navigation
  • Drop any folder with SKILL.md into C:\vibefuse\skills and it appears after a catalog refresh
  • Connected provider agents (Claude, Codex, Cursor, …) can also read these files — they are standard Agent Skills, not VibeFuse-only

Publish or polish a skill from Settings → Marketplace or Account → Marketplace Settings. Step-by-step: Write a skill — the full guide.

Local marketplace packages

Widget types

Built-in widgets come from the left rail. CLI widgets are live PTY sessions; Browser and YouTube are embedded Chromium panes; Files is a workspace explorer; Vibe Agent is a tool-using chat. Use the tabs to open each type.

Terminal

System PowerShell / pwsh / cmd as a widget. No extra install. Use it as a scratch shell beside agents. Default working directory comes from Settings → General; each session can override it with a workspace path. Scrollback and cwd persist across restarts.

Terminal widget

Browser

Embedded Chromium with back/forward/reload, URL bar, zoom, and Save current page as widget. URL and zoom persist on that instance. Browser and YouTube widgets share one browser session partition and render with a dark theme inside the canvas.

Browser widget

YouTube

A focused YouTube viewer that loads youtube.com with minimal chrome: page zoom controls only (no URL bar, back/forward, or reload). Widget header still offers fill-view and close. In-app navigation within YouTube works normally.

YouTube widget

Files

Browse the session workspace folder. Inline previews for images, video, audio, and PDFs; open a file in its default app or reveal it in Explorer. The starting folder follows the session workspace path (or your home folder).

Files explorer

Files preview

Vibe Agent

A dedicated chat widget that uses your Settings → Agent provider. It shares the assistant toolset: create/arrange/remove widgets, read and type into terminals, navigate and screenshot browsers, run web_search via local SearXNG, call your MCP tools, create / edit / delete / execute Agent Skills, and speak short lines. Replies render as GitHub-flavored Markdown; each widget keeps its own message memory. Ask it to “write a skill named …” and the Skills rail refreshes as soon as create_skill returns.

Vibe Agent chat

Agent empty state

Agent activity

Claude

Claude Code CLI (claude --max-turns 10000). Install: npm i -g @anthropic-ai/claude-code. The widget can target a local FreeClaudeCode proxy on 127.0.0.1:8082 with a dummy key when that server is running. Env keys: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY.

Agent widget chrome

Codex

OpenAI Codex CLI. Install: npm i -g @openai/codex. Set OPENAI_API_KEY in Settings → Agent or the process environment. Install or uninstall any agent from Settings → Agent.

CLI cards including Codex

Gemini

Google Gemini CLI. Install: npm i -g @google/gemini-cli. Env: GEMINI_API_KEY or GOOGLE_API_KEY.

Provider & CLI icons

Cursor

Cursor Agent CLI (agent / cursor-agent). Install via PowerShell: irm 'https://cursor.com/install?win32=true' | iex. Env: CURSOR_API_KEY.

Widget context menu

Qwen

Qwen Code CLI. Install: npm i -g @qwen-code/qwen-code. Env: DASHSCOPE_API_KEY or OPENAI_API_KEY.

Widget dock pills

HyperFrames

Local HyperFrames Studio in a canvas webview. Workspace C:\vibefuse\hyperframes, preview on http://127.0.0.1:4567. Start / Restart / Stop from Settings → Local Servers, or click Open widget. Vibe Agent tools: hyperframes_compose, hyperframes_init, hyperframes_render, create_video_widget. Requires Node.js 20+ on PATH. See HyperFrames.

HyperFrames wait

Video

Play a local video file — typically an MP4 from C:\vibefuse\hyperframes\renders after hyperframes_render. The agent can spawn this with create_video_widget and a path.

Video player

Custom / marketplace widgets

Iframe widgets from the marketplace library, from a folder with manifest.json + index.html, or saved pages bookmarked from the Browser widget. They appear under Widgets (not a separate Custom rail). Marketplace packages sync automatically; drop-in packages load from C:\vibefuse\widgets. Host API version is stable so the public marketplace can grow without rewriting the canvas. Agent Skills are a different package type — see Agent Skills.

Marketplace iframe widget

HyperFrames wait

Video player

Widget creation guide

Want the full walkthrough with a live example, listing polish, pricing, and troubleshooting? Read the dedicated creator guides: Build a widget · Write a skill · Design a styling pack.

A widget is a folder. VibeFuse scans the marketplace roots (and the app widgets/ tree) for manifest.json and serves the package over the widget:// protocol.

  1. Create a folder, for example hello-card, inside the marketplace path from Settings → Widgets.
  2. Add manifest.json with a unique id such as com.yourname.hello-card.
  3. Add index.html (or set entry). The iframe runtime loads that file.
  4. Restart VibeFuse or reopen Settings so the catalog rescans.
  5. Spawn the widget from the rail / catalog once it appears.
{ "id": "com.yourname.hello-card", "name": "Hello Card", "version": "1.0.0", "description": "My first VibeFuse widget.", "author": "Your name", "license": "MIT", "icon": "sparkles", "category": "utility", "kind": "marketplace", "runtime": "iframe", "entry": "index.html", "permissions": ["storage"], "defaultSize": { "w": 4, "h": 6 }, "minSize": { "w": 3, "h": 4 }, "tags": ["custom"] }

Permissions you may declare: pty, shell, network, webview, fs.read, fs.write, clipboard, storage, voice. Only request what the widget needs.

Categories: cli, browser, utility, media, custom. Layouts use free-form x, y, w, h, z on the canvas. Keep WIDGET_PROTOCOL_VERSION compatibility in mind — the host API is versioned so marketplace packages stay loadable.

Ready to share it? Publish the folder straight from Settings → Marketplace (see below). Uploads accept text files (html, css, js, mjs, json, svg, md, txt, map) up to 750 KB each, and your profile name is stamped as the author.

Settings → Widgets catalog

Widget settings cards

Marketplace — widgets & Agent Skills Live

The marketplace is live at /marketplace — discover widgets and Agent Skills on the web, save them to your library, run them on the canvas, and publish your own from the desktop app or polish them in Account → Marketplace Settings.

In-app marketplace browse

On the web — /marketplace

  • Live pulse — trending widgets, trending skills, trending sellers, and staff picks in a rotating spotlight (click the dots in the clone above)
  • Widget catalog — every published widget in one grid; each card shows category, saves, and Free tag
  • Skills catalog#skills on the same page; each skill is a savable SKILL.md package with a detail page at /marketplace/skill/{slug}
  • Widget pages — banner, screenshot slider with captions, rich “About this widget” description, version/category/saves/views meta, and Save to VibeFuse
  • Skill pages — description, SKILL.md preview, owner, version, and Save to VibeFuse (writes the skill into your library)
  • Sellers — seller cards with follower and listing counts; follow creators to catch their next widget or skill drop
  • Your library — the hero shows how many widgets and skills you have saved while signed in

Saving a widget downloads it into C:\vibefuse\widgets and lists it under Widgets. Saving a skill downloads SKILL.md + manifest.json into C:\vibefuse\skills and lists it under Skills. Sync runs at launch and when you close the in-app marketplace webview.

In the app — browse & sync

  • The Marketplace action under Widgets (or Settings → Marketplace → Open marketplace) opens the browse modal — the full website in a themed webview
  • Closing the modal triggers an immediate library sync of widgets and skills; the app also syncs at launch
  • Settings → Marketplace shows your linked license, widgets folder, skills folder, local packages (including saved skills), and live sync results

Publish a widget from Settings → Marketplace

  1. Link a valid VF- key (the tab shows your seller profile; there is a shortcut to Product Keys if not).
  2. Build the package: a folder with manifest.json + entry file (see the creation guide).
  3. Open Settings → Marketplace. Local widgets scans your widgets folder — each card shows its status: Not on marketplace, Uploaded · unpublished, or Live on marketplace.
  4. Click List on marketplace to publish a new widget, or Update listing to push new files and metadata for one already listed. Choose other folder publishes any folder outside the marketplace directory; Reveal folder opens it in Explorer.
  5. Uploaded-but-unpublished listings show a Publish all (N) banner — one click makes every hidden listing live.
  6. Watch results in the tab: your listings show version, status, saves and installs counts, with Unpublish / Publish buttons per widget and a View link to the public page.

Uploads accept text files (html, css, js, mjs, json, svg, md, txt, map) up to 750 KB each; your profile name is stamped as the author automatically. Republishing the same folder updates the listing in place.

Manage your listings on the website — Account → Marketplace

The seller dashboard is where listings get polished after upload. It lists every widget and skill on your profile (published and unpublished):

  • Widgets — name & descriptions, card image & banner, screenshot slider with captions, Published / Unpublished, saves / views
  • Skills — create a new skill, edit slug / short description / SKILL.md body (paste markdown or upload a .md file), Save draft, Publish, Unpublish
  • Stats — saves, detail views, and a link to the live public page for each listing

Settings → Marketplace

Styling pack publish

Your library and listings both sync by VF- key — the same key that licenses the app. Widgets land in C:\vibefuse\widgets; skills land in C:\vibefuse\skills as SKILL.md + manifest.json. Keep author accurate or let VibeFuse stamp your profile name.

Local Servers — Piper, Whisper, HyperFrames, Skill Seekers, crawl

Settings → Local Servers is the fourteenth Settings tab. It is where on-device engines live: Piper TTS, Whisper STT, HyperFrames Studio, Skill Seekers MCP, and the Crawl4AI + SearXNG web stack. Voice wake-word and mic/speaker devices stay on Settings → Voice; this tab owns endpoints, models, and start/stop.

Settings → Local Servers

Piper TTS

ControlWhat it does
Piper endpointOpenAI-compatible /v1/audio/speech URL. Default http://127.0.0.1:4123. The bundled piper.exe fills this when local-first is healthy.
VoiceJarvis (default), Lewis, Michael, Adam, Heart, Bella, Emma. Jarvis uses jarvis.onnx (British RP) cached by the installer.
SpeedSlider 0.50–2.00 (default 1.45× for Jarvis). Applies to spoken replies and the “Yes, sir?” ack cache.
VolumeSlider 0–150%. Also used for wake-word audio, video widgets, and browser webviews when session mute is off.
Test PiperProbes STT + TTS and shows Speech ready/down · Piper ready/down.

Whisper STT

ControlWhat it does
Whisper endpointLocal transcribe API used when the bundled server is down. Default http://127.0.0.1:8935.
Whisper modelDropdown: Tiny English quantized (fastest), Tiny English, Base English quantized, Base English, Small English quantized, Small English. Changing the model restarts the local Whisper server. Options not on disk are marked not installed.

Models live under %LOCALAPPDATA%\VibeFuse\models\ as ggml-*.bin. Tiny English is the live-voice default; the installer also caches ggml-base.en-q5_1.bin. ffmpeg on PATH is required for microphone conversion.

HyperFrames card

  • Workspace C:\vibefuse\hyperframes · Studio port 4567
  • Buttons: Start Studio / Restart / Stop / Open widget
  • State pill: ready / connecting / error / disabled. Needs Node.js 20+.
  • Chips: Studio UI, Init, Preview, Render, Capture

Skill Seekers card

  • Local Python MCP from yusufkaraaslan/Skill_Seekers at C:\vibefuse\Skill_Seekers
  • Connect / Disconnect — VibeFuse clones the repo, creates a venv, and starts FastMCP. Requires Python 3.11+ (3.12 preferred). No API key.
  • Chips: Find skills, Docs → skill, GitHub repo → skill
  • Starts with the desktop app so Vibe Agent can search presets before calling create_skill

Crawl4AI + SearXNG

  • SearXNG endpoint — default http://127.0.0.1:51452 for web_search / firecrawl_search
  • Crawl4AI endpoint — default http://127.0.0.1:11235 for scrape / map / crawl (local Python sidecar, no Docker, no Firecrawl Cloud)
  • Start web tools / Refresh — starts the sidecar; if it is down, scrape still uses a built-in fetch fallback
Local-first means these processes bind localhost. Do not expose 4123 / 8935 / 4567 / 8765 / 11235 / 51452 to the internet.

HyperFrames — HTML-to-video on the canvas

HyperFrames is a local HTML-to-video studio. VibeFuse starts it with npx hyperframes@latest, binds the workspace root so the Renders tab lists C:\vibefuse\hyperframes\renders, and embeds Studio in a widget. Ask Vibe Agent or Jarvis to make a video about the current workspace folder — it inspects README / package.json, composes scenes, checks, renders an MP4, and can spawn a Video widget.

HyperFrames Studio wait

Agent toolWhat it does
hyperframes_statusStudio state, studioUrl, workspace dir, active session folder
hyperframes_open / create_hyperframes_widgetStart Studio if needed and place the widget on a session canvas
hyperframes_inspect_workspaceFile tree + README/package.json so the video is about that project
hyperframes_initScaffold a project under C:\vibefuse\hyperframes (blank starter — always compose next)
hyperframes_composeRequired before render — writes a visible composition from the prompt + workspace. Skipping this yields a black MP4
hyperframes_write / hyperframes_readEdit files inside the HyperFrames directory only
hyperframes_runCLI verbs: catalog, check, preview, lint, and other HyperFrames commands
hyperframes_renderRender MP4 into C:\vibefuse\hyperframes\renders
create_video_widgetPlay the rendered MP4 on the canvas

Bundled skills such as hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-cli, and media-use live in the Skills rail so Claude / Codex / Cursor widgets can follow the same composition contract. See the HyperFrames landing page.

Skill Seekers — find a skill before you invent one

Skill Seekers is a local Python MCP that scrapes documentation and packages Claude-compatible SKILL.md folders. VibeFuse clones the repo to C:\vibefuse\Skill_Seekers, builds a venv, and exposes tools to Vibe Agent. The desktop lookup skill (skill-seekers-lookup) tells the agent to call list_configs first so you do not duplicate React, Godot, Blender, Claude Code, Unity, or other presets.

  1. Install Python 3.11+ (3.12 recommended) and Git. The app looks in %LOCALAPPDATA%\Programs\Python\Python312 and C:\Python312.
  2. Open Settings → Local Servers → Skill Seekers → Connect. First run clones and installs; later launches reuse the venv.
  3. Ask Vibe Agent: “Is there already a skill for React / Godot / this docs site?” It runs skill-seekers-lookup then Skill Seekers MCP tools.
  4. To build a new skill from docs: generate a config, scrape, then package. Packaged output can land under C:\vibefuse\skills.
  5. If tools are missing, reconnect the card. Python must use UTF-8 stdio (VibeFuse sets PYTHONUTF8=1 so emoji logs do not crash on Windows cp1252).

No cloud API key. The MCP HTTP port is 8765 on localhost. Publish a finished skill from Account → Marketplace Settings or Settings → Marketplace — free or paid. See Skill Seekers and Sell AI skills.

Sell widgets & skills — Stripe Connect, 80% payout

The marketplace is a creator economy, not just a free dump. List a widget or Agent Skill as Free or paid ($0.50–$500.00). Buyers check out through Stripe. You receive 80% of each sale; Fuse Intelligence keeps a 20% platform fee. Payouts go to your connected Stripe account.

  1. Sign in and finish a public seller profile (display name, avatar, optional bio / storefront banner) in Account → Marketplace.
  2. Open Account → Stripe Connect and complete onboarding until charges and payouts are enabled.
  3. Publish a widget from Settings → Marketplace (folder with manifest.json + entry) or a skill from Account → Marketplace Settings (slug, short description, SKILL.md body).
  4. Set a USD price. Paid prices require Stripe to be fully enabled. Leave $0.00 for Free.
  5. Polish the listing: card image, banner, screenshot slider + captions, long description. Publish.
  6. When someone buys, they get the package in their VibeFuse library; you see net earnings on Account Overview (7-day seller chart) and in Stripe.
  • Minimum paid price $0.50 · maximum $500.00 · two decimal places
  • Application fee is taken at checkout — you never invoice buyers yourself
  • Unpublish hides the listing without deleting the package folder
  • Followers see your next drop on the marketplace pulse and your storefront
VibeFuse the harness stays free. You profit from your skills, widgets, and styling packs — not from a VibeFuse subscription. Creator guides: widgets · skills · styling packs.

Account, profile settings, and the community forum

The same Fuse Intelligence account licenses VibeFuse, syncs notes, owns your marketplace library, and posts on the forum. Nothing here is a second login.

Account Overview & settings

  • Display name, theme, accent — site chrome (dark/light + hex accent). Desktop themes stay in Settings → Appearance (nine presets).
  • Avatar — used on the forum, seller cards, and marketplace storefront. Clear or upload from Account settings.
  • Forum signature — appended to your posts.
  • Notes email + cloud notes — where VocalFuse / VibeFuse Note-Taking summaries can be delivered; cloud notes toggle for Account → Notes sync.
  • Product Keys — complimentary VF- key. Required for desktop marketplace sync, publish, and notes upload.
  • Downloads — installer and exe for the linked license.
  • Stripe Connect — seller onboarding for paid listings.
  • Marketplace / Skills marketplace — polish listings, set prices, publish, unpublish, view saves / views / earnings.
  • Overview chart — 7-day marketplace views or net seller earnings after the platform fee.

Forum

  • Hub: /community · threads: /forum
  • Public forums (not staff-only), thread pages, user profiles at /forum/u/{id}, ranks at /forum/ranks (Spark through Apex, plus Administrator crown)
  • Notifications (bell) for replies, marketplace saves/purchases, and staff messages — /api/notifications
  • Discord: same community, live chat — linked from the hub

Seller storefronts and forum profiles are public. Account settings pages are noindex — they are not SEO targets.

Canvas control — let Jarvis design your layout

Jarvis (the voice assistant, by wake word or hold-to-talk) and the Vibe Agent chat widget can both redesign the canvas on command. Ask in plain language and the assistant picks the right tool — spawning widgets, tiling them across the view, resizing, renaming, stacking, and clearing, all on the active session.

“Jarvis — open three terminals and tile them.” “Open a browser with the docs and fill the top half, Claude below it.” “Rename Browser 2 to Docs and bring it to the front.” “Screenshot the Claude widget and tell me what’s on screen.” “Close every widget and start a clean review layout.”

What the assistant can do

ToolWhat it does
list_canvas_widgetsLists open widgets with instanceId, title, type, layout, and the visible view rectangle so placements fit your screen
create_terminal / create_cli_widgetSpawn 1–6 terminal or agent widgets (Claude, Codex, Gemini, Cursor, Qwen…), placed with arrange or exact coordinates
create_browser_widget / create_youtube_widgetOpen browser or YouTube widgets preloaded with a URL, domain, or search query — sized and placed on request
layout_widgetThe design tool — move/resize one widget or a batch. arrange="tile" / "fill" / "row" / "column" reflows selected widgets across the current view (with optional columns), or set precise x, y, w, h per widget
focus_widget / rename_widgetRaise a widget to the front of the stack or give it a new title
remove_widgetClose widgets by id, title, type, provider, or all=true to clear the canvas
screenshot_widgetCapture any widget and analyze it with your vision-capable model
read_terminal / type_terminal / waitRead output from a live terminal, type into it, and wait for output before reading again
navigate_browser_widget / get_browser_htmlPoint an open browser or YouTube widget at a new URL, or read its live HTML
web_searchLive internet search through your local SearXNG endpoint
play_ttsSpeak a short line aloud through Piper (Jarvis voice)
list_skills / create_skill / update_skill / delete_skillDiscover, write, patch, or remove Agent Skills in C:\vibefuse\skills — see Agent Skills
execute_skill / read_skill / read_skill_fileRun a skill against the current task, or load SKILL.md / supporting files
hyperframes_* / create_video_widgetCompose and render HTML-to-video, then play the MP4 — see HyperFrames
firecrawl_search / firecrawl_scrape / firecrawl_mapSearXNG search plus Crawl4AI scrape/map of a URL
Your MCP toolsAnything connected in Settings → Tools or Local Servers (Google, GitHub, Copilot, Discord, Linear, Skill Seekers, custom stdio) is callable the same way

Good to know:

  • Layout changes apply to the active session and respect the current zoom/pan view — “fill the view” means the visible canvas, not the whole virtual plane
  • Spawning up to 6 CLI/terminal widgets or 4 browser widgets per call; layouts can be passed as layouts[] or a widgets[] batch
  • The assistant always calls list_canvas_widgets first when it needs to find widgets by name
  • Prefer the no-code side? Settings → Navigation edits the rail manually, and Settings → Appearance redesigns every surface with nine theme presets
  • Richer scripted theming surfaces (per-widget styling APIs) remain planned

Canvas topbar

Workspace folder popover

Folder picker

System prompt editor

Settings

Open the gear in the title bar. Fourteen tabs, grouped Workspace / Assistants / Library / System. The sidebar has a Search field that filters tab names.

Settings modal

Settings sidebar

General

Appearance

Navigation editor

Updates

About

Local Servers

History

Shared controls

Themed select

Chips & badges

Dark Snow styling pack

TabWhat it controls
GeneralDefault cwd; install missing agents on launch and when a widget spawns
AppearanceTheme presets (nine), accent color, reduce motion
NavigationLeft-rail editor — Agents, Widgets, Skills system sections; rename, reorder, hide items (including skills) without deleting folders
MarketplaceLicense status, widgets folder, skills folder, Open marketplace, List / Update listing, Publish all, Unpublish, local widget + skill packages, styling pack publish
UpdatesRelease feed from fuseintelligence.org (same as /updates/vibefuse)
VoiceJarvis wake word, microphone and speaker devices, Test voice. Piper voice/speed/volume also appear on Local Servers.
Local ServersPiper endpoint + voice + speed + volume + Test Piper; Whisper endpoint + model (restarts local STT); HyperFrames Start/Restart/Stop/Open widget; Skill Seekers Connect; SearXNG + Crawl4AI endpoints + Start web tools
AgentLLM provider grid (OpenAI, Ollama Local/Cloud, NVIDIA NIM, Featherless, Gemini, Groq, Together, OpenRouter, Plugsky, Custom), Test connection, agent CLI install / uninstall
NotesVoice-note sessions synced to Account → Notes; edit and delete
ToolsGoogle Workspace, Google Drive, GitHub PAT, GitHub Copilot, Discord, Linear OAuth, HyperFrames / Skill Seekers / Crawl4AI cards, plus custom stdio (command + args + On)
WidgetsBuilt-in + marketplace catalog and C:\vibefuse\widgets
SkillsLocal + marketplace skill cards, Hide / Show, Remove folder, C:\vibefuse\skills
HistoryVoice history — transcripts and replies, with clear
AboutLogo, version 0.1.23, check for updates, license status

Troubleshooting

SymptomFix
PTY is only available on desktopUse the VibeFuse window, not a browser tab on the Vite port.
CLI missingLeave auto-install on, install from Settings → Agent, or run the installer again.
Agent does not appear in the railOnly installed agents show. Install it in Settings → Agent, then rescan.
Voice does nothingAllow the microphone. Use Test voice in Settings → Voice. Local STT also needs ffmpeg on PATH.
Wake word not triggeringEnable Settings → Voice → Jarvis wake word (Normal mode only). Grant the mic and say “Jarvis” clearly.
Local engines missingRe-run the installer — it fills %LOCALAPPDATA%\VibeFuse\bin (whisper-cli.exe, piper.exe) and …\models (Whisper, jarvis.onnx). Then open Settings → Local Servers and Test Piper.
HyperFrames Studio will not startInstall Node.js 20+ on PATH. Use Settings → Local Servers → Start Studio. Workspace must stay under C:\vibefuse\hyperframes.
Skill Seekers failed to startInstall Python 3.11+ and Git. Connect the card again so the venv rebuilds. Confirm C:\vibefuse\Skill_Seekers exists.
Crawl4AI not readySearch still works via SearXNG. Click Start web tools. Scrape falls back to a built-in fetch if the Python sidecar is down.
Cannot set a paid priceFinish Stripe Connect until charges and payouts are enabled. Minimum $0.50.
No spoken replyLocal Piper runs first; without it, a configured provider must return speech and Piper must be reachable.
Marketplace library emptyConfirm your VF- key is valid, then refresh in Settings → Marketplace. Widgets and skills you save on the web sync at launch.
Skill missing from the railConfirm a folder with SKILL.md exists under C:\vibefuse\skills. Check Settings → Skills — it may be Hidden. Ask Vibe Agent to list_skills.
Vibe Agent cannot create a skillConfigure a provider in Settings → Agent and Test connection. Then ask it to write a kebab-case name + description; create_skill writes the folder and refreshes the rail.
Google Workspace / Drive not readySign in with Google on Settings → Tools. If tools fail with “API has not been used…”, click Enable Workspace APIs, then Connect again. Both cards share one OAuth account.
Provider test failsEach card has its own key. OpenRouter uses sk-or-… at openrouter.ai/api/v1; Plugsky uses sk-live-… at api.plugsky.com/v1; Ollama Local needs the daemon on 127.0.0.1:11434.
Publish failedWidgets: valid manifest.json (id, name, version) plus the entry file; text files ≤ 750 KB. Skills: name, slug, and SKILL.md body from Account → Marketplace Settings.
Notes not uploadingNote-Taking needs a provider in Settings → Agent and a valid VF- key. Check Account → Notes and Settings → Notes for the error.
Custom widget missingValid manifest.json in the marketplace folder; restart the app.
Canvas blank after maximizeUpdate to v0.1.23 or later; the app remeasures on window resize.
Update stuckUse Settings → Updates → Open timeline or re-download VibeFuseInstaller.exe from /downloads/VibeFuse/.
Installer cannot fetch the exeConfirm /downloads/VibeFuse/ lists VibeFuse.exe at v0.1.23.

Boot crash screen

VibeFuse FAQ

Is VibeFuse free?

Yes. Every Fuse Intelligence account gets a complimentary VF- license at no charge. There is no checkout and no monthly fee for VibeFuse. Create a free account, copy your key from Account → Product Keys, and install from /downloads/VibeFuse/.

What harness tools does VibeFuse include?

VibeFuse is a high-capability Windows AI agent harness: Terminal (PowerShell), Browser, YouTube, Files explorer, a Vibe Agent chat assistant that can create and edit Agent Skills, AI coding agent widgets for Claude Code, Codex CLI, Gemini CLI, Cursor CLI, and Qwen, Google Workspace and Drive MCP connections, and a live marketplace for community widgets and SKILL.md packages.

Does VibeFuse include free voice transcription?

Yes. Hold the title-bar voice dock to record. Speech is transcribed locally on your PC with whisper.cpp for free — useful for dictating prompts into AI coding agents without cloud audio uploads.

Does VibeFuse support a wake word?

Yes. Enable the Jarvis wake word in Settings → Voice and say “Jarvis”. VibeFuse plays a short “Yes, sir?” acknowledgement, then records your command. Local Whisper and Piper keep the whole loop on your PC.

How does Note-Taking mode work?

Switch the voice dock to Note-Taking, click the orb to record, and click again to stop. VibeFuse transcribes the take locally, summarizes it into bullet points with a title, and uploads it to your profile — review notes at Account → Notes or in Settings → Notes.

Can the assistant control the canvas layout?

Yes. Jarvis (voice) and the Vibe Agent chat widget can spawn, tile, resize, rename, focus, and remove widgets on command — for example “Jarvis, open three terminals and tile them.” Layouts use tile/fill/row/column arrange modes or exact x/y/w/h coordinates.

Does VibeFuse include free text-to-speech (TTS)?

Yes. Replies are spoken by Piper with the Jarvis voice, running on-device. With an OpenAI-compatible chat provider configured, the voice assistant speaks a short reply line — free local TTS for developer workflows, not a cloud TTS subscription.

Is VibeFuse open source?

VibeFuse is a free Fuse Intelligence product that wraps and runs popular open-source and vendor AI coding CLIs (Claude Code, Codex, Gemini, Cursor, Qwen) in one desktop canvas. Agent CLIs remain theirs; VibeFuse is the free harness, marketplace, voice, and session layer.

How do I install VibeFuse?

Register for free, copy your VF- key from Account → Product Keys, download VibeFuseInstaller.exe from /downloads/VibeFuse/, paste the key in Setup, and launch. The installer fetches the app and missing local voice models before first run.

Where is the widget marketplace?

Browse fuseintelligence.org/marketplace — save widgets and Agent Skills to your library while signed in. Widgets sync into C:\vibefuse\widgets and skills into C:\vibefuse\skills on next launch.

How do I publish a widget to the marketplace?

Build a folder with manifest.json and index.html, open Settings → Marketplace in the desktop app, and publish the folder. Your listings appear publicly on fuseintelligence.org/marketplace, and you can unpublish or republish any time.

What are Agent Skills in VibeFuse?

Agent Skills are Claude/Codex-compatible SKILL.md folders in C:\vibefuse\skills. They appear in the left-rail Skills section. Save them from the marketplace, drop a folder on disk, or ask Vibe Agent to create_skill / update_skill. Any connected provider agent can read the same files.

Can Vibe Agent create and edit skills?

Yes. Vibe Agent (and Jarvis) can list_skills, create_skill, update_skill, delete_skill, execute_skill, read_skill, and read_skill_file. The Skills rail and Settings → Skills refresh as soon as a skill is written.

How do I connect Google Workspace or Google Drive MCP?

Open Settings → Tools. Use the Google Workspace card (Gmail, Drive, Calendar, Docs, Sheets, Tasks, Slides, Meet, Contacts) or the Google Drive card (read-only Drive). Sign in with Google once — both cards share the same OAuth account — then Connect. Enable Workspace APIs in Google Cloud if tool calls fail.

Which AI providers does VibeFuse support?

Settings → Agent includes OpenAI, Ollama (Local), Ollama Cloud, NVIDIA NIM, Featherless, Google Gemini, Groq, Together AI, OpenRouter, Plugsky, and Custom OpenAI-compatible endpoints. Each card keeps its own API key, endpoint, and model.

What is Settings → Local Servers?

The fourteenth Settings tab: Piper endpoint/voice/speed/volume, Whisper endpoint and ggml model picker, HyperFrames Studio start/stop, Skill Seekers Connect, and Crawl4AI + SearXNG endpoints.

Can I sell skills I create in VibeFuse?

Yes. Finish Stripe Connect, set a price on Account → Marketplace, and publish. Sellers keep 80%. Buyers get the package in C:\vibefuse\skills or \widgets.

What is HyperFrames in VibeFuse?

A local HTML-to-video studio on port 4567. Vibe Agent can compose a video about your workspace folder, render an MP4 to C:\vibefuse\hyperframes\renders, and spawn a Video widget.

What is Skill Seekers?

A local Python MCP cloned to C:\vibefuse\Skill_Seekers. It searches docs-to-skill presets (React, Godot, Blender, Claude Code, Unity, and more) before you create a duplicate skill. No API key.