---
title: Chronicle for Go
editUrl: https://github.com/Cratis/Chronicle.Go/edit/main/Documentation/index.md
description: Register typed events and append them securely to Cratis Chronicle from Go.
lastUpdated: 2026-10-06T00:00:00.000Z
---


Chronicle.Go is the Go client SDK for Cratis Chronicle's event store. Without the client, you manage OAuth, structural compatibility, schemas and RPC envelopes yourself; with it, you register event structs and append facts through context-aware store handles.

## Start here

[Append your first event](/chronicle/go/clients/go/getting-started/) using a local development kernel. Requires Go 1.26 or newer. The API remains experimental in the v0.x release series.

## Use the foundation

- [Connecting and lifecycle](/chronicle/go/connection-strings/): endpoints, TLS, OAuth and ownership.
- [Event types](/chronicle/go/events/event-types/): stable identities, generations and supported JSON shapes.
- [Serialization](/chronicle/go/serialization/): property naming, migration and shared Fundamentals values.
- [Appending events](/chronicle/go/events/appending-events/): full results, metadata and concurrency protection.
- [Event enrichment and auditing](/chronicle/go/events/enrichment/): declared-field editing and per-call audit snapshots.
- [Identity display names](/chronicle/go/identities/): one update with acknowledgment and bounded name observation.
- [Atomic batches](/chronicle/go/events/batches/): ordered mixed-source events and independent checks.
- [Reading events](/chronicle/go/events/reading-events/): complete history and expectations derived from loaded state.
- [Reactors](/chronicle/go/reactors/): plain closures, convention handlers and optional scoped services.
- [Reducers](/chronicle/go/reducers/): nullable state folds, convention discovery and passive reads.
- [Read models](/chronicle/go/read-models/): typed reads, best-effort watches and materialized windows.
- [Definition factories](/chronicle/go/definition-factories/): prepare projections, constraints and migrations from configuration.
- [Shared-provider client preparation](/chronicle/go/facade-composition/): bind one borrowed client identity before preparing its definitions.
- [Decision reads](/chronicle/go/read-models/decision-reads/): admitted optimistic projection guards and owner-controlled commits.
- [Read-model reactors](/chronicle/go/read-model-reactors/): Added/Modified/Removed callbacks with scoped effects.
- [Patterns](/chronicle/go/patterns/): contextual and usual-action questions with honest empty answers.
- [Parity and limitations](/chronicle/go/parity/): executable evidence and deliberate C# differences.
- [Release policy](/chronicle/go/releases/): module versioning and experimental compatibility.

Contracts target Chronicle 19.32.3; kernel-backed tests run against 19.32.3-development. Basic projections, event reactors, reducers and supervised recovery are available; advanced observer features remain incomplete. Inclusion in the central Cratis documentation site remains a separate site integration.