Extension manager
The Coordigent extension shows your agents inside VS Code: what needs you, who is working, which files are in use, and which files other agents are editing right in the editor. It reads everything from coord on your machine.
Install
The extension is not on the VS Code Marketplace yet. Until it is, install it from a .vsix file: in VS Code, open the Extensions view, choose … → Install from VSIX…, and pick the file. Or from a terminal:
code --install-extension coordigent.vsixIt needs VS Code 1.85 or later, and coord installed on the machine (see Install). Without coord, the extension offers to install it.
It shows itself
You do not have to go looking for it:
- In a folder that uses Coordigent — a connected repo, or one where an agent is already working — the Coordigent view opens on its own the first time. The setting
coordigent.autoRevealchanges this:firstRun(the default),alwaysornever. - If setup is not finished — no
coord, not logged in, or the repo not connected — it opens the Get started with Coordigent walkthrough: installcoord,coord login,coord connect, start an agent. Each step ticks itself when it is done. ⌘⇧;on macOS orCtrl+Shift+;elsewhere opens Coordigent from anywhere.- When an agent in this repo first needs you, one notification says so, with Open.
- When Coordigent asks to connect a repo this window has open, one notification asks, with Set up, Always for my repos and Not now. See Connect a repo.
Who you are
The views show Signed in as ‹name› · ‹project›, taken from this machine's coord login. Logged out, the Agents view has a Log in button: it runs coord login in a terminal and the views update on their own once you approve, with no reload and nothing to paste. For a self-hosted or staging server, set Coordigent: Server Url in your user settings: Install coord installs from it and Log in logs in to it, each after asking you to confirm the server. A repo's own settings can't set it, or Coord Path.
You never type an agent id. Any action that needs an agent offers a list, with the one whose terminal is focused first. Message agent… and Take over agent… also list your teammates' agents and your agents on other machines, and Message agent… offers everyone in the project.
The views
The Coordigent icon in the activity bar carries a badge with the Needs you count. It holds five views:
- Needs you. Agents that are Blocked or Waiting on you, agents with unread messages, and finished runs. Click a row to jump to the agent's terminal, or open its record.
- Agents. Live agents grouped by repo, each with its status, app, branch, context %, lines added and removed, and unread messages. Expand one to see the files it edited (click to open the diff) and any conflicts. Show ended agents includes ended ones.
- Team. Everyone in your project, you first, each with their repos, their live agents and the files those agents are in. It updates live as teammates' agents start, edit and end. Logged out it offers Log in.
- Runs. Runs still going, then the newest finished ones.
- Files in use. Each file an agent is working in and who holds it. A file two agents hold reads
Conflict · 2 agents.
In the editor, a file another agent holds gets a ● in the Explorer and on its tab, a mark in the gutter, and a hover naming the agent. The first time you type in one, a notification warns you; nothing is blocked. coordigent.decorations.enabled turns these marks off.
The status bar shows how many agents are working and how many need you. Click it for a menu: Open Coordigent, Needs you, Open dashboard, Start agent…, Run doctor and Settings, with whatever fixes the current problem at the top.
Actions
Run these from the Command Palette, a view's context menu, or the agent record:
| Command | Does |
|---|---|
| Start agent… | Starts an agent in a new worktree, in a VS Code terminal |
| Start headless agent… | Starts a run with no terminal; tells you when it is done |
| Message agent… | Sends a message to any agent in the project, or to everyone; the agent reads it at its next step |
| Stop agent… | Stops an agent, after you confirm |
| End agent… | Marks an agent on another machine ended for everyone and clears its conflicts; nothing is stopped. Its own person, the project's owner or an admin, after you confirm |
| Dismiss conflict… | Dismisses an open conflict for everyone in the project |
| Invite teammate… | Creates an invite to your project |
| Open record on the website | Opens the agent's record on the website |
| Open agent record… | A tab with the agent's status, edited files, messages, latest handoff, and boxes to ask or review |
| Ask agent… / Review agent… | Asks a read-only copy of the agent a question, or has another agent review its diff; both use model credits and ask first |
| Show handoff… | Shows the handoff an agent left |
| Take over agent… | Picks up another agent's work in a terminal |
| Open in dashboard | Opens the agent, file or conflict on the website |
| Connect this repo | Runs coord connect in a terminal in this folder; also turns Coordigent back on after an unenroll |
| Unenroll this folder | Stops Coordigent for you in this repo, on this machine, after you confirm. See Connect a repo |
| Remove repo from project… | Takes the repo out of the project for everyone, keeping its history or deleting it; owners only. See Connect a repo |
| Run doctor | Shows coord doctor for this folder |
| Open in TUI | Opens the live view in a terminal |
How it talks to coord
The extension never reads or writes Coordigent's files itself. It asks the coord daemon on this machine through the local API, a socket only your user can open. The daemon tells it the moment something changes, so a new agent or a teammate's edit shows up within a second. If the daemon is not running, it falls back to running coord api every 2 seconds and the status bar says daemon stopped; Start daemon brings it back. If coord is older than the extension needs, it offers Update coord.
This extension shows Coordigent's own views. To give Copilot in VS Code the Coordigent tools, see VS Code and Copilot.
Next
See this machine for the daemon the extension reads from.