Skip to content

Integrations

RemoteJuggler integrates with AI coding assistants through standardized protocols.

Protocol Support

Protocol Target Transport Status
MCP Claude Code, VS Code, Cursor STDIO Stable
ACP JetBrains IDEs STDIO Stable

Architecture

sequenceDiagram
    participant Agent as AI Agent
    participant RJ as RemoteJuggler Server
    participant Git as Git/SSH
    participant KC as Keychain

    Agent->>RJ: initialize (protocol version)
    RJ-->>Agent: capabilities, tools

    Agent->>RJ: tools/call juggler_detect_identity
    RJ->>Git: git remote get-url origin
    Git-->>RJ: remote URL
    RJ-->>Agent: detected identity

    Agent->>RJ: tools/call juggler_switch
    RJ->>Git: git config user.name/email
    RJ->>KC: retrieve token
    KC-->>RJ: token
    RJ-->>Agent: switch result

Available Tools

All integrations expose the same set of tools (see src/remote_juggler/Tools.chpl:52-209):

Tool Description
juggler_list_identities List configured identities
juggler_detect_identity Detect identity for repository
juggler_switch Switch to identity
juggler_status Get current status
juggler_validate Validate connectivity
juggler_store_token Store token in Keychain
juggler_sync_config Sync configuration

Integration Options

User-Level Configuration

Configure RemoteJuggler globally for all projects:

~/.claude/mcp.json: 

{
  "mcpServers": {
    "remote-juggler": {
      "command": "remote-juggler",
      "args": ["--mode=mcp"]
    }
  }
}

~/.jetbrains/acp.json: 

{
  "agent_servers": {
    "RemoteJuggler": {
      "command": "remote-juggler",
      "args": ["--mode=acp"]
    }
  }
}

Project-Level Configuration

Configure RemoteJuggler for a specific project:

.mcp.json in project root: 

{
  "mcpServers": {
    "remote-juggler": {
      "command": "remote-juggler",
      "args": ["--mode=mcp"]
    }
  }
}

Protocol Documentation