OpenMono Agent
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. |
Links
License
AGPL-3.0-or-later.
