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:

1. Build and test the agent locally without signing in to Avaamo.
2. Sign in from the Avaamo Account view with your domain, email address, and PIN.

SSO-only accounts can open the Avaamo login page from the Account view, then paste an Avaamo access token into the same view. Avaamo: Sign In and Avaamo: Set Access Token both focus 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:

1. Run avaamo init — this creates the agent git repository on the server and sets the remote URL in your local workspace.
2. 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.