Skip to content

Getting Started

This section covers installation, configuration, and first-time setup of RemoteJuggler.

Overview

RemoteJuggler provides a unified interface for managing multiple git identities across providers. The installation process:

  1. Downloads a platform-specific binary
  2. Creates configuration at ~/.config/remote-juggler/config.json
  3. Imports existing identities from ~/.ssh/config
  4. Optionally configures IDE integrations (Claude Code, JetBrains)

Requirements

  • macOS (arm64 or amd64) or Linux (amd64)
  • SSH keys configured per-identity in ~/.ssh/config
  • Optional: glab CLI for GitLab token operations
  • Optional: gh CLI for GitHub token operations

Quick Install

curl -sSL https://raw.githubusercontent.com/tinyland-inc/remote-juggler/main/install.sh | bash

This script handles platform detection, binary download, and initial configuration. See Installation for detailed options.

Verify Installation

# Check version
remote-juggler --version

# List detected identities
remote-juggler list

# Show current status
remote-juggler status

Next Steps