cursord

A lightweight daemon that connects to a control plane and executes AI agent tasks in your environment.

Install

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

Or non-interactively:

curl -fsSL https://cursord.jasonsmale.com/install.sh | CURSORD_CONTROL_PLANE=https://your-api.com bash

Manual Download

• Linux (x86_64)
• Linux (ARM64)
• macOS (Intel)
• macOS (Apple Silicon)

Usage

cursord run --control-plane https://your-api.com --name "my-daemon" --tools /path/to/tools.json

Configuring Tools

Tools are defined in a JSON file. Each tool has a name, description, parameters (JSON Schema), and a shell command template.

{
  "tools": [
    {
      "name": "execute_sql",
      "description": "Execute a SQL query",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "SQL query" }
        },
        "required": ["query"]
      },
      "command": "psql \"$DATABASE_URL\" -c {{.query | shellquote}}",
      "env": ["DATABASE_URL"],
      "timeout": 30000
    }
  ]
}

Template Functions

shellquote - Safely quotes values for shell use. Always use this for user input.

"command": "cat {{.filename | shellquote}}"

Environment Variables

• CURSORD_CONTROL_PLANE - Control plane URL
• CURSORD_NAME - Daemon display name
• CURSORD_TOOLS - Path to tools.json

Daemon Management

Linux (systemd)

sudo systemctl status cursord
sudo journalctl -u cursord -f

macOS (launchd)

launchctl list | grep cursord
tail -f ~/Library/Logs/cursord/cursord.log