Prerequisites

  • Go 1.24+ — Chronos requires Go 1.24 or later. Verify with go version.
  • C compiler — Required for SQLite CGO bindings (github.com/mattn/go-sqlite3). On macOS, Xcode Command Line Tools provide this. On Linux, install build-essential or equivalent.

Install the module

Add Chronos to your Go module:

go get github.com/spawn08/chronos

The module path is github.com/spawn08/chronos. Import it in your code:

import "github.com/spawn08/chronos/sdk/agent"

Build from source

Clone the repository and build:

git clone https://github.com/spawn08/chronos.git
cd chronos
make build
  • make build — Compiles all packages and builds the CLI binary at bin/chronos.
  • make build-all — Compiles every package, including examples.

To install the CLI binary to $GOPATH/bin:

make install

Binary installation

Cross-compiled binaries are available for common platforms. Build them with:

make build-cross

This produces binaries in bin/ for:

  • linux/amd64
  • linux/arm64
  • darwin/amd64
  • darwin/arm64

Binaries are named chronos-<os>-<arch> (e.g., chronos-darwin-arm64).

Verify installation

From the project root:

go build ./...
go vet ./...

Both commands should complete without errors. Run the test suite:

make test