Gimble

Monorepo for Gimble robotics debugging and observability.

Packages

Package	Description
gimble-ros	ROS2 system context collection, CLI (gim), and telemetry HTTP server

Quick start

make build
make install-hooks   # optional: run tests before each push
# or from gimble-ros:
cd gimble-ros && go build -o ~/.local/bin/gim ./cmd/gim/main.go && go build -o ./telemetry ./cmd/telemetry/main.go

See gimble-ros/README.md for full documentation.

Testing

• CI: Sanity tests run on every push and PR (.github/workflows/sanity.yml).
• Pre-push hook: Run make install-hooks to run tests locally before each push. If tests fail, the push is blocked.
• Branch protection: In GitHub repo settings, require the "Sanity" status check before merge to enforce tests even if --no-verify is used.

Releases

Tag and push to trigger the release workflow:

git tag v0.1.0
git push origin v0.1.0

See scripts/apt/KEY_SETUP.md for APT signing setup.