Installation

Option 1: Install CLI (recommended)

Pre-built binaries for Linux, macOS, and Windows:

curl -fsSL https://raw.githubusercontent.com/spawn08/chronos/main/install.sh | bash

Verify:

chronos version

See CLI Install for platform-specific details and manual download options.

Add Chronos as a library to your Go project:

go get github.com/spawn08/chronos

Requirements: Go 1.24+, C compiler (for SQLite via CGO).

git clone https://github.com/spawn08/chronos.git
cd chronos
make install  # installs the `chronos` binary to $GOPATH/bin (on your PATH)

Or build a local binary without installing:

make build       # outputs to bin/chronos
./bin/chronos version

Ensure $GOPATH/bin (usually ~/go/bin) is on your PATH so the chronos command resolves after make install.

Run the quickstart example (no API keys needed):

go run ./examples/quickstart/