Pre-built binaries

Download the latest release for your platform from the Releases page.

Available platforms: Linux (amd64, arm64, armv7, i386), macOS (amd64, arm64), Windows (amd64, arm64).

Each release archive contains recur (CLI) and recurd (daemon). Plugins are distributed separately — the first-party plugins live in their own repositories under the directedbits org and are installed via recur install (see Plugins).

Using Go

With Go 1.25+:

  go install github.com/directedbits/recur/src/app/recur@latest   # CLI (recur)
go install github.com/directedbits/recur/src/app/recurd@latest  # Daemon (recurd)

Building from source

Requires Go 1.25+ and Task.

  git clone https://github.com/directedbits/recur.git
cd recur
task build          # outputs bin/recur and bin/recurd

Installing plugins

The first-party plugins are maintained in their own repositories under the directedbits org and published as release archives. Install one from its release URL:

  recur config set allowed_hosts github.com
recur install https://github.com/directedbits/recur-timer/releases/download/v0.1.0/timer-v0.1.0-linux-amd64.tar.gz

See Plugins for the full catalog and installation details.

Protobuf generation

Requires buf v1.66.0+:

  task generate

Generated .pb.go files are gitignored. Run task generate after cloning or changing .proto files.