Skip to content
Documentation

Documentation

libfossil is a pure-Go library and CLI for reading and writing Fossil SCM repositories. Zero CGo. Static binaries. WASM-ready.

What you’ll find here

  • Quickstart — install the CLI, clone a repo, and read its history from Go in five minutes.
  • Architecture — module layout, storage model, driver layer, and the deterministic simulator.
  • Migration from Fossil — for upstream Fossil users: what’s covered, what isn’t, and how the CLI shapes differ.
  • Extension Points — observer interfaces for telemetry, custom SQLite drivers, and the db.DB abstraction.
  • Production patterns — error handling, context, telemetry wiring beyond the quickstart’s log.Fatal shortcuts.
  • Testing — running the suite, the dual-driver matrix, and DST simulation with seeds and BUGGIFY.
  • SDK reference — auto-generated Go API reference, one page per package.