Aigis Remote
The Aigis Remote extension connects your editor to Aigis workspaces with a
single click.
Features
- One-click workspace access - open workspaces from the Aigis dashboard or
the editor sidebar. Workspaces start automatically when opened.
- Multi-editor support - works with VS Code, Cursor, Devin Desktop
(formerly Windsurf), and other VS Code forks.
- Workspace sidebar - browse, search, and create workspaces. View agent
metadata and app statuses at a glance.
- Multi-deployment support - connect to multiple Aigis deployments and
switch between them without losing credentials.
- Dev container support - open dev containers running inside workspaces.
- Secure authentication - session tokens stored in the OS keyring
(macOS/Windows), with optional OAuth 2.1 support.
- Air-gapped / restricted networks - no external dependencies beyond your
Aigis deployment.
- Automatic SSH tuning - applies recommended SSH settings for reliable
long-lived connections and recovers from sleep/wake.
[!NOTE]
The extension builds on VS Code-provided implementations of SSH. Make sure you
have the correct SSH extension installed for your editor
(ms-vscode-remote.remote-ssh, anysphere.remote-ssh for Cursor, or
codeium.windsurf-remote-openssh for Devin Desktop).
Getting Started
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press
enter.
ext install AigisCode.aigis-remote
Alternatively, manually install the VSIX from the
Visual Studio Marketplace.
Extension settings are available in the Settings UI. Paths accept ~ and
${userHome} from VS Code's
variables reference.
Several settings involving paths, commands, hostnames, and proxy bypass lists
are excluded from Settings Sync via ignoreSync, because their values can
depend on the specific machine or network where they were set.
[!WARNING]
Do not give extension settings "scope": "machine". In a remote window
VS Code filters machine-scoped keys out of the local User
settings.json, so such a value only holds until the extension registers
its schema on activation. After that, the next re-parse of settings.json
(from an edit, a Settings Sync write, a profile switch, or a tasks.json
load) drops the value back to its default, with no remote-side copy to
fall back on. Use application scope instead: it is honored in remote
windows regardless of timing.
URI Handler
The extension registers a URI handler that can open workspaces from outside
the editor, such as links on the Aigis dashboard. The scheme matches the
editor (vscode://, cursor://, devin://, etc.), followed by the
extension ID and a path:
vscode://AigisCode.aigis-remote/open?owner=alice&workspace=dev&agent=main&folder=/home/user/project
/open
Opens a workspace, starting it first if needed.
| Parameter |
Required |
Description |
owner |
Yes |
Username of the workspace owner. |
workspace |
Yes |
Name of the workspace. |
agent |
No |
Agent name (not ID). If omitted or unmatched in a multi-agent workspace, a picker is shown. |
folder |
No |
Absolute path inside the workspace to open. If omitted, a recently opened folder for this workspace is used (a picker is shown when there are several); with no recents, the window opens without a folder. |
openRecent |
No |
Open the most recently used folder for this workspace, skipping the picker. True when present without a value or set to true. Ignored when folder is set. |
url |
No |
Aigis deployment URL. If omitted, the extension prompts for it (pre-filled with the current deployment). |
token |
No |
Session token for authentication. If omitted, the existing session is used or a login flow is started. |
/openDevContainer
Opens a dev container running inside a workspace.
| Parameter |
Required |
Description |
owner |
Yes |
Username of the workspace owner. |
workspace |
Yes |
Name of the workspace. |
agent |
Yes |
Agent name the dev container runs on. |
devContainerName |
Yes |
Name of the dev container. |
devContainerFolder |
Yes |
Folder to open inside the dev container. |
localWorkspaceFolder |
No |
Local path of the dev container project. Required if localConfigFile is set. |
localConfigFile |
No |
Local path to the devcontainer.json file. |
url, token |
No |
Same as /open. |
