Log

Changes.
In order.

Updates to the event log, HTTP API, and developer tooling.

In development
API↗

One endpoint for events and batches.

POST /events accepts a single event or a nonempty array. Each request is atomic and retains input order. Recorded events return after storage confirms durability.

Append reference
Storage↗

Ordered batches. Durable storage.

The writer groups concurrent requests while keeping client batches intact. Readers expose durable events in append order. Configurable limits bound pending requests and accounted bytes.

Durability and failures
Tooling↗

Ingestion load testing.

The groundhog-load executable exercises durable ingestion through the HTTP API. Trial scripts coordinate workloads and summarize throughput and batch latency for comparison.

Start locally
Storage↗

The event log.

The initial implementation stores immutable JSON events with a source, ID, and recording timestamp. The HTTP service supports durable append, retrieval by ID, and ordered reads.

API reference

About this site.

Groundhog is infrastructure for companies building agents. This site explains the product architecture and the current event log implementation.

The interactive examples use illustrative data. They do not connect to applications or execute external actions. Early access remains a placeholder in this preview.

Read the API reference