Publisher: StartupHakk · Extension ID: StartupHakk.openmono-agent

Chat with the OpenMono coding agent without leaving your editor. OpenMono is an open-source, local-first coding agent — your code never leaves your network and there is no per-token billing. This extension brings its full agentic loop into a VS Code / Cursor side panel.

The agent does the thinking (the LLM, sessions, memory, tools, and playbooks). The extension is the chat surface: it shows streamed responses, runs the agent inside Docker on your machine, and asks for your approval before anything touches your files.

What you can do

Chat with full streaming — responses, reasoning, and tool calls render live as the agent works.
Attach files and images — type @ to reference any file in your workspace, or drag, paste, or attach images (PNG, JPG) for the agent to read.
Plan Mode and Build Mode — start in read-only Plan Mode to explore safely, then approve a plan to switch into Build Mode where the agent edits code.
Approve every action — when the agent wants to run a command or write a file, you get a permission card: Allow once, Allow for this session, or Deny. Destructive actions are flagged.
Watch the work — tool calls appear as collapsible cards with status, and sub-agent activity is grouped into expandable logs.
Stay in control — stop a running turn at any time (Stop button or Esc), clear the session, and switch folders in multi-root workspaces.

How it works

VS Code / Cursor (this extension)  ──HTTP/SSE──►  OpenMono agent (Docker, :7475)  ──►  LLM

The extension talks to a local OpenMono agent over HTTP. The agent must run on the same machine as your editor — it executes tools in your workspace, so it has to see your files. The LLM (inference) can live anywhere:

Full setup — agent and inference both run on this machine (one box with a capable GPU, or Apple Silicon).
Dual-box setup — the agent runs on this machine, inference runs on a separate GPU machine. Either way, the agent stays local to your editor.

When you open a project and start the agent, the extension launches it for you in a Docker container scoped to that folder. Docker is required.

Requirements

VS Code 1.85+ or Cursor
Docker — installed and running (the extension spawns the agent in a container)
OpenMono agent installed on this machine — see the OpenMono install guide. Choose a full setup (agent + inference here) or a dual-box setup (inference on a separate machine); in both cases the agent must be installed on the machine running your editor.

Quick start

Install the OpenMono agent on this machine following the OpenMono setup guide. Pick a full or dual-box configuration and confirm it runs.
Make sure Docker is running.
Install this extension from the marketplace (search OpenMono Agent) or from a .vsix.
Open your project folder in VS Code or Cursor.
Open the OpenMono Agent panel from the activity bar and click Start Agent. The extension spins up the agent for the open folder and connects automatically.
Start chatting. You begin in Plan Mode — describe what you want, review the plan, then approve it to let the agent build.

Settings

Setting	Default	What it does
`openmono.agentImage`	`openmono-agent:latest`	Docker image the extension runs for the agent.
`openmono.agentLifecycle`	`managed`	`managed` stops the container when the editor closes; `persistent` leaves it running for faster reconnects.
`openmono.dockerCommand`	`docker`	Path to the Docker CLI. Set this to the full path if `docker` isn't on your `PATH`.
`openmono.acpPort`	`7475`	Port the extension uses to reach the agent.

LLM settings (endpoint, model, API key) belong to the agent, in ~/.openmono/settings.json (%USERPROFILE%\.openmono\settings.json on Windows) — not in this extension.

Commands

Open the Command Palette (Ctrl/Cmd+Shift+P) and search OpenMono Agent:

Command	What it does
Start Agent for Workspace	Connect to (or launch) the agent for the open folder.
Stop Agent	Disconnect and stop the managed container.
Clear Session	Reset the conversation.
Select Workspace Folder	Choose which folder the agent serves in multi-root workspaces.

Troubleshooting

Symptom	Fix
Agent won't start / Docker error	Confirm Docker is installed and running. If `docker` isn't on your `PATH`, set `openmono.dockerCommand` to its full path.
No agent found for this workspace	The agent runs per folder — make sure you started it for the folder currently open in the editor.
Port 7475 already in use	Stop the conflicting process, or change `openmono.acpPort` (it must match the agent's port).
Agent installed but nothing connects	Re-check the OpenMono setup guide — verify the agent is installed on this machine and inference is reachable.