AgentSync

Multi-agent coordination for VS Code.

AgentSync is built for design and product teams using AI agents (Claude, Codex, Copilot) in the same repo. It reduces collisions, keeps handoffs visible, and provides clear status feedback while work is in progress.

Quick Start

1. Install AgentSync from the VS Code Marketplace.
2. Run AgentSync: Initialize Workspace.
3. Open AgentSync: Open Live Dashboard.
4. (Optional) Run AgentSync: Open Interactive Tutorial for guided onboarding.
5. Start work with AgentSync: Start Session, then close with AgentSync: End Session.

Why AgentSync

• Prevents multi-agent conflicts with shared workspace conventions.
• Keeps current status visible through a live dashboard and status bar signals.
• Standardizes handoffs and end-of-session notes in one place.
• Supports non-technical contributors with guided checklist and recovery actions.

Core Workflow

Each agent reads a different workspace instruction file:

All instructions point to AgentTracker.md, the shared handoff file.

AgentTracker.md tracks:

• Last session metadata (agent/date/summary/branch/commit)
• Current health (build/test/deploy)
• Hot files touched recently
• Active work in progress
• Suggested next work and known gotchas

Live Dashboard

Run:

AgentSync: Open Live Dashboard

The AgentSync Live view includes:

• live operational state (Ready, Busy, Waiting)
• compact mode by default with a lightweight memory summary (active goal + top in-progress tasks)
• compact core actions (Start Session, End Session, Clear Active Session, Open AgentTracker) with More for secondary actions
• header toggle (Show Full / Show Compact) with mode preference remembered per workspace
• active command highlighting with process-specific button colors while actions are running
• full dashboard mode with quick action buttons (Initialize, Start/End Session, open tracker/handoffs)
• Action Center with running/completed/failed command feedback
• built-in onboarding checklist (Initialize -> Start -> End)
• failure recovery shortcuts (Open Tracker, Refresh)
• handoff buckets (Assigned to me, Shared with me, Blocked/Stale)

Interactive Tutorial

Run:

AgentSync: Open Interactive Tutorial

This opens a VS Code Getting Started walkthrough with clickable steps for:

• opening the live dashboard
• initializing the workspace
• starting a session
• ending a session with updated tracker state

Command Usage

1. Initialize a workspace

AgentSync: Initialize Workspace

Creates:

CLAUDE.md
AGENTS.md
.github/copilot-instructions.md
AgentTracker.md
.agentsync.json

2. Start and end sessions

Start:

AgentSync: Start Session

End:

AgentSync: End Session

End Session updates:

• Last Session (agent/date/summary/branch/commit)
• Current Health (configured checks)
• Hot Files (from git changes)
• In Progress (cleans completed entry)
• Suggested Next Work (optional note)

With automation.endSessionZeroTouch.enabled: true, End Session switches to mostly zero-touch behavior:

• active-session agent is reused automatically when available
• one-line summary is deterministically generated, then shown once for confirm/edit
• hot-file handoffs are auto-routed from routing defaults when possible
• if routing confidence is missing, one compact fallback prompt is used (single, shared, auto, or skip)
• one-line handoff prompts are generated, stored in .agentsync/handoffs.json/.agentsync/state.json, and can be copied to clipboard in interactive mode

3. Status bar feedback

The status bar item shows the latest session agent and warns when:

• tracker data is stale (older than configured threshold)
• tracker branch differs from current branch
• tracker commit is not in current HEAD history

Clicking the status item opens AgentSync Live.

4. Multi-root behavior

In multi-root workspaces, AgentSync targets the active editor's workspace folder and labels status with the folder name.

Optional Configuration

AgentSync reads optional config from .agentsync.json:

{
  "staleAfterHours": 24,
  "autoStaleSessionMinutes": 0,
  "requireHandoffOnEndSession": false,
  "automation": {
    "endSessionZeroTouch": {
      "enabled": false,
      "autonomy": "mostly_full_auto",
      "copyPromptToClipboard": true,
      "maxSummaryLength": 180
    },
    "handoffRoutingDefaults": {
      "claude": { "owner_mode": "single", "to_agents": ["codex"], "required_capabilities": [] },
      "codex": { "owner_mode": "single", "to_agents": ["claude"], "required_capabilities": [] },
      "copilot": { "owner_mode": "single", "to_agents": ["codex"], "required_capabilities": [] }
    }
  },
  "commands": {
    "build": "npm run build",
    "test": "npm test",
    "deploy": "npm run deploy"
  }
}

If commands are empty or missing, that check is marked Not configured.

autoStaleSessionMinutes:

• 0 disables stale-session detection (default)
• >0 shows Waiting instead of Busy when active session age exceeds threshold

automation.endSessionZeroTouch:

• starts disabled by default (feature-flag rollout)
• deterministic summary uses active goal + hot-file context + health counts
• interactive mode can copy generated handoff prompt lines to clipboard
• drop-zone/headless mode never writes to clipboard, but still returns/stores generated prompt lines

Requirements

• VS Code ^1.86.0
• A folder/workspace open in VS Code
• Git available on PATH for hot-file and branch/commit checks

Privacy and Data

• AgentSync stores coordination files in your workspace (AgentTracker.md, .agentsync/ files).
• It does not require an external service to function.
• Review your workspace and extension telemetry settings for your environment policy.

Install from VSIX

1. Download the latest .vsix from Releases.
2. In VS Code, open Extensions -> ... -> Install from VSIX.

AgentTracker Reference

Update these sections at the end of every session:

Recommended Team Flow

1. Agent: Start Session
2. Agent: Implement work on a branch
3. Agent: Run checks
4. Agent: End Session
5. Human: Review and merge

Development Packaging

Local refresh:

npm run vsix:refresh

Related commands:

npm run vsix:package   # package only -> agentsync-local.vsix
npm run vsix:install   # install existing agentsync-local.vsix

If VS Code CLI is not on PATH (Windows example):

$env:CODE_CLI="C:\Users\<you>\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd"
npm run vsix:refresh

License

MIT