Avaamo Harness
VS Code and Cursor extension wrapper for Avaamo agent workspaces.
Created by Avaamo.
Developer Experience
After install, the extension adds an Avaamo icon to the Activity Bar. Opening it shows an Account view plus workspace tools for agents, recent local agent workspaces, and grouped actions.
On first use, developers can choose one of two paths:
- Build and test the agent locally without signing in to Avaamo.
- Sign in from the Avaamo Account view: pick your instance (h1 by default, or Others to type a domain such as
h1.avaamo.com) and click Sign in. The dashboard opens in your browser; sign in there as usual and it sends you back to the editor.
Avaamo: Sign In focuses the Account view instead of opening input prompts.
Developers can then use the Avaamo Activity Bar or command palette to:
- create a new agent from a webview form and pull it into a local workspace
- pull an existing agent by selecting it from the Avaamo agent list
- pull dashboard changes into the current workspace with merge safety
- open a created or selected agent on Avaamo
- open or add the pulled workspace to VS Code/Cursor
- edit the agent files with any IDE or LLM coding assistant
- run status, diff, chat check, serve, regression UI, and docs
Deploy
Prerequisites: you must have access to your company's Avaamo GitHub account and SSH keys configured for git.
To push changes to the Avaamo server:
- Run
avaamo init — this creates the agent git repository on the server and sets the remote URL in your local workspace.
- Use git commands to review and push your changes.
Only code merged to main is deployed to Avaamo servers.
Pulled workspaces include AGENTS.md, CODEX.md, and avaamo-bot-project.json to guide assistants on safe CLI and extension actions; if avaamo is not on PATH, use ./.avaamo/bin/avaamo or Command Palette commands instead.