Setup

Install and run cursord on your machine

Quick Install

The fastest way to get started. This script detects your OS and architecture, downloads the appropriate binary, and installs it to /usr/local/bin.

curl -fsSL https://cursord.com/install.sh | bash

Manual Installation

If you prefer to download and install manually, choose your platform below.

macOS

# Download for Apple Silicon (M1/M2/M3)
curl -fsSL https://d.cursord.com/cursord-darwin-arm64 -o cursord
chmod +x cursord
sudo mv cursord /usr/local/bin/

# Or for Intel Mac
curl -fsSL https://d.cursord.com/cursord-darwin-amd64 -o cursord
chmod +x cursord
sudo mv cursord /usr/local/bin/

Linux

# Download for x86_64
curl -fsSL https://d.cursord.com/cursord-linux-amd64 -o cursord
chmod +x cursord
sudo mv cursord /usr/local/bin/

# Or for ARM64
curl -fsSL https://d.cursord.com/cursord-linux-arm64 -o cursord
chmod +x cursord
sudo mv cursord /usr/local/bin/

Running the Daemon

Once installed, start the daemon to connect to the control plane. By default, it connects to https://c.cursord.com.

# Start the daemon (connects to production by default)
cursord start --workers 4

# Or with a custom name
cursord start --workers 4 --name my-daemon

Options

--workers: Number of concurrent workers (default: 1)
--name: Display name for this daemon
--control-plane: Custom control plane URL (for local development)
--tools: Path to custom tools JSON file

Docker

Run cursord in a Docker container. This is useful for isolated environments or when you want to include custom tools.

# Download the Dockerfile
curl -fsSL https://cursord.com/Dockerfile.cursord -o Dockerfile

# Build the image
docker build -t cursord .

# Run the container
docker run -it --rm cursord

Download Dockerfile

Local Development

To connect to a local control plane instead of production:

cursord start --control-plane http://localhost:3001 --workers 4