About - Project Tick

Overview

tickborg is a RabbitMQ-based distributed CI system that:

Automatically detects changed projects in PRs
Builds affected sub-projects using their native build systems (CMake, Meson, Autotools, Cargo, Gradle, Make)
Posts build results as GitHub check runs
Supports multi-platform builds (Linux, macOS, Windows, FreeBSD)

PRs automatically trigger builds for affected projects based on:

File path detection: Changed files are mapped to sub-projects
Conventional Commits: Commit scopes like feat(meshmc): trigger builds for the named project

Example commit titles and the builds they will start:

Message	Automatic Build
`feat(meshmc): add chunk loading`	`meshmc`
`cmark: fix buffer overflow`	`cmark`
`fix(neozip): handle empty archives`	`neozip`
`chore(ci): update workflow`	(CI changes only)

If the title of a PR begins with WIP: or contains [WIP] anywhere, its projects are not built automatically.

The comment parser is line-based. Commentary can be interwoven with bot instructions.

@tickbot build meshmc neozip cmark

This will build the specified projects using their configured build systems.

@tickbot test meshmc

This will run the test suite for the specified projects.

@tickbot eval

Triggers a full evaluation of the PR — detects changed projects and labels the PR.

$ git clone https://github.com/project-tick/Project-Tick/
$ cd Project-Tick/ofborg
$ cd tickborg
$ cargo build
$ cargo check
$ cargo test

Make sure to format with cargo fmt and lint with cargo clippy.

See example.config.json for a minimal configuration and config.public.json for the production config.