fuseraft for VS Code

Chat with fuseraft agents in an interactive REPL panel, right in your editor — plus task runs, sessions, and config tools.

fuseraft.ai · GitHub

Features

REPL Chat Panel

fuseraft: Open REPL opens an interactive chat panel beside your editor.

fuseraft REPL

Model dropdown — switch models live from the header; list is fetched from your provider via fuseraft models, history is preserved
Streaming responses — one thought at a time live, each replacing the last as the next begins; the full response reveals in full, broken into bordered blocks, once it's done
Tool call badges — click to expand arguments, hover for a summary
Markdown rendering — headers, bold/italic, links, images, blockquotes, horizontal rules, code blocks with a one-click copy button, tables, lists
Stop button — interrupt mid-stream and immediately redirect
Slash commands — /plan, /execute, /compact, /tools, /sessions, /help, and more
Resumable sessions — snapshots stored at ~/.fuseraft/repl-sessions/
File change summary — files added, modified, renamed, or deleted appear below each response
Shift+Enter for multi-line input; Enter to send

Activity Bar Panel

A dedicated fuseraft panel with seven views:

Run Task — compose and launch tasks from a webview form:

Multi-line task textarea with + Files (passed via --context-file) and + Spec (injected into every agent's system prompt via --spec) attach buttons
Config dropdown, flag checkboxes (HITL, tool calls, verbose, snapshot), and Run Task / Run Task File… buttons

Sessions — lists sessions scoped to the current workspace. Click to resume; right-click to view transcript, open config, or delete.

Configs — discovers fuseraft YAML/JSON configs in your workspace. Click to open; + to run the Initialize Config wizard.

Context — manages reference material in .fuseraft/context/. + to import files or folders; right-click to remove.

Memory — lists entries from ~/.fuseraft/memory/repl, grouped by type with each entry's description shown inline. Click to open the entry's markdown file; right-click to delete one entry or clear them all.

Skills — lists skills discovered under the fuseraft home's skills/ directory. Click to open SKILL.md; + to add a skill, right-click to remove one.

Objectives — lists objectives (.fuseraft/knowledge/objectives/OBJ-*.yaml) in the current workspace, with status and task-completion percentage shown inline. + to create one; right-click for the full status detail.

Other Features

CodeLens — ▶ Run Task, ✓ Validate, and ⎇ Diagram actions above the first line of any config file
Session Transcript Viewer — rich panel showing every agent turn, tool calls with ✓/✗ indicators, per-turn token usage, and session totals
Right-click menus — run, validate, or diagram config files; run task files directly from the Explorer
Status bar button — always-visible fuseraft shortcut to run a task

Command Palette

Command	Description
`fuseraft: Open REPL`	Interactive chat panel with streaming responses and tool call badges
`fuseraft: Run Task`	Prompt for a task, pick a config, run in the integrated terminal
`fuseraft: Run Task File with fuseraft`	Run a `.md` or `.txt` task file
`fuseraft: Resume REPL Session`	Pick a saved REPL session and resume it in the chat panel
`fuseraft: Initialize Config`	Wizard: template → model → provider → output path
`fuseraft: Validate Config`	Validate a config file
`fuseraft: Validate Config and Show Diagram`	Validate and print a Mermaid flowchart
`fuseraft: Resume Session`	Pick an incomplete session to resume
`fuseraft: View Session Transcript`	Open a formatted transcript for a session
`fuseraft: Add Context`	Import a file or folder into the context store
`fuseraft: Remove Context Item`	Remove a context item
`fuseraft: Delete Memory`	Delete a memory entry
`fuseraft: Add Skill`	Add a skill to the fuseraft home's `skills/` directory
`fuseraft: Remove Skill`	Remove a skill
`fuseraft: Create Objective`	Create a new objective for the current workspace
`fuseraft: View Objective Status`	Show an objective's full status and task progress
`fuseraft: Knowledge GC (Dry Run)`	Preview knowledge lifecycle cleanup (archived ADRs, decayed memories) without changing anything
`fuseraft: Knowledge GC (Apply)`	Apply knowledge lifecycle cleanup to disk
`fuseraft: Check Architecture Compliance`	Scan the workspace for architecture layer violations
`fuseraft: Install CLI`	Run the fuseraft installer in the integrated terminal
`fuseraft: Update CLI`	Update the fuseraft CLI to the latest release
`fuseraft: Set Binary Path`	Pick or enter the path to the fuseraft binary
`fuseraft: Set Home Directory`	Override the fuseraft home directory (`~/.fuseraft` by default)
`fuseraft: Configure fuseraft`	Configure your AI provider, model, and API key

Requirements

fuseraft CLI installed and on your PATH
VS Code 1.85 or later

Extension Settings

Setting	Default	Description
`fuseraft.binaryPath`	`fuseraft`	Path to the fuseraft binary
`fuseraft.homeDir`	(blank)	Override the fuseraft home directory (`~/.fuseraft` by default); matches the CLI's `FUSERAFT_HOME`
`fuseraft.defaultConfigPath`	(blank)	Default config path relative to workspace root
`fuseraft.runFlags`	(blank)	Extra flags appended to every `fuseraft run` invocation
`fuseraft.openTerminalOnRun`	`true`	Focus the terminal when a task starts

Development

npm install && npm run compile

Press F5 to launch an Extension Development Host. To package: npx vsce package.

License

MIT