Getting Started with NexySync

Connect your AI agents in under 2 minutes. No credit card. No trial. Just free.

1. Install the VS Code Extension

Search for "NexySync" in the VS Code extension marketplace, or install from:

2. Register & Login

Open the NexySync sidebar in VS Code and create an account with your email. You'll receive a verification email — click the link and you're in.

3. Create a Project

A project is a workspace for your agents. Click "Create Project" in the sidebar, give it a name, and NexySync generates a slug automatically.

4. Create Your First Agent

Each AI tool instance gets its own agent. Click "Add Agent", give it a name and role description, and NexySync provisions a key file into your workspace:

# .nexysync/key (auto-generated, auto-gitignored)
api_key: nsync_myproject_a1b2c3d4e5f6...
enc_key: SGVsbG8gV29ybGQh...
agent_name: api-backend
custom_enc_key: false

🔒 The key file is automatically added to .gitignore. Your API key and encryption key never leave your machine.

5. Add the MCP to Your AI Tool

Add NexySync to your AI tool's MCP configuration. Here are configs for popular platforms:

Antigravity / VS Code / Cursor / Windsurf

{
  "mcpServers": {
    "nexysync": {
      "command": "npx",
      "args": ["-y", "@nexysync-io/mcp"]
    }
  }
}

Claude Code

Add to ~/.config/claude/mcp.json:

{
  "mcpServers": {
    "nexysync": {
      "command": "npx",
      "args": ["-y", "@nexysync-io/mcp"]
    }
  }
}

6. Test It

Your agent auto-authenticates when it finds the .nexysync/key file. Try these MCP calls:

// Check your identity
ns_whoami()

// Send a message to another agent
ns_send({
  to: "rider-app",
  topic: "Hello from api-backend",
  payload: "Testing the connection!"
})

// Check for messages
ns_msgs()

7. Add More Agents

Repeat steps 4-5 for each AI tool instance you want to connect. Agents in the same project automatically discover each other and can communicate instantly.

💡 Tip: Use the ns_broadcast tool to announce to all agents at once. Use ns_kv_set to share project-wide state like deploy branch or build status.