Safe Agent v2 VSCode Extension

Local-first AI coding assistant with a modern UI, Git integration, and intelligent features.

Key Features

Auto-Start Server: The agentd server starts automatically when you open the chat panel -- no manual setup required.
Multi-Mode Operation: Ask (Q&A), Plan (shows steps), Agent (auto-executes)
Git Integration: Smart git commands with AI-generated commit messages
Context Management: Add files and folders for contextual code assistance
Local-First: All processing happens on your machine with local LLMs
Clean UI: Icon-based interface with tooltips and collapsible sections

Quick Start

Development Mode

npm install
rm -rf dist
npm run build
# Press F5 in VSCode to launch Extension Development Host

Production Install

rm -rf dist
npm run build
npx vsce package --out safe-agent-v2.vsix --allow-star-activation
code --install-extension safe-agent-v2.vsix

See INSTALL.md for detailed installation instructions.

Auto-Start Server

When you open the Safe Agent chat panel (Cmd+Shift+P > Safe Agent: Chat), the extension automatically starts the agentd server if it is not already running. The extension searches for the binary in this order:

The path configured in safeAgent.serverBinaryPath (if set)
<workspace>/bin/agentd
<workspace-parent>/bin/agentd
$GOPATH/bin/agentd
System PATH

To disable auto-start, set safeAgent.autoStartServer to false in your VSCode settings.

Server output is available in the Safe Agent Server output channel (View > Output > select "Safe Agent Server").

Settings

Setting	Default	Description
`safeAgent.agentAddress`	`http://127.0.0.1:7777`	Safe Agent local service address.
`safeAgent.autoStartServer`	`true`	Automatically start the agentd server when the chat panel is opened.
`safeAgent.serverBinaryPath`	`""`	Explicit path to the `agentd` binary. If empty, the extension auto-discovers it.
`safeAgent.maxMessages`	`100`	Max chat messages retained per session.
`safeAgent.maxContextBytes`	`200000`	Max bytes of file context per request.
`safeAgent.contextExtensions`	`[".ts", ...]`	Extensions included when adding folders.
`safeAgent.contextExcludeFolders`	`["node_modules", ...]`	Folder names excluded during scans.
`safeAgent.responseMode`	`auto`	Response mode (ask, plan, agent).

Chat Sessions

Safe Agent: New Chat Session creates a new local session.
Sessions are stored under .safe-agent/chat/.
Safe Agent: Export Chat Session writes a markdown file under .safe-agent/chat/exports/.

Safe Agent

Divya Bairavarasu