VeillaxandClaude Sonnet 5.5 4bde85ea33
CI / test (push) Successful in 1m23s
model: terminal sessions in the site config, and the agent's SSH server in its report
SiteConfig.Terminals lists terminal sessions waiting for the agent, which calls
back to Hammerhead and joins the connection to its SSH server. SiteReport and
Site carry the SSH server's address and whether the agent can relay.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-31 01:38:16 -06:00
2026-10-26 02:40:53 -06:00

Reef

A shared library for Hammerhead, Blacktip, Bamboo and Sandbar

Shared types and building blocks for the sharks stack: Hammerhead (control plane), Blacktip (edge) and Bamboo (site agent).

Reef holds the code all three programs agree on, so each can be built and released from its own repository.

Package What it is
model The data types passed between the programs: edges, sites, ports, mail egress, DKIM keys, alert-relevant status and reports
tunnel The wire format used inside the WireGuard tunnel, and the helper that pipes two connections together
wg wireguard-go with a userspace network stack: no root, no kernel interface, works on Windows, macOS and Linux
authtoken Signed, expiring login tokens with a revocation epoch
netguard Refuses internal addresses for anything that connects out on a user's behalf (webhooks, mail delivery), and dials the address it checked
docker Lists running containers through the Docker Engine API, with no SDK
dotenv Loads a .env file into the environment without overriding real variables
secretbox AES-256-GCM sealing of small secrets (enc1: values) before they are written to a database

Using it

go env -w GOPRIVATE=git.veillax.com   # once, so Go fetches straight from this server
go get git.veillax.com/Veillax/reef@latest

Tests

go test ./...

License

AGPL-3.0. See LICENSE.

S
Description
A shared library for Hammerhead, Blacktip, Bamboo, and Sandbar
Readme AGPL-3.0
180 KiB
0 Stars 1 Watchers 0 Forks
Languages
Go 100%