About Gimble

Gimble is a small Go runtime for programs that ask agents to do work. It makes the workflow visible in the code and keeps a record of each run.

Why it exists

Agent workflows still need ordinary program structure: a lifetime for each piece of work, clear ownership of sessions and goroutines, cancellation that reaches the agent, and a way to see what happened afterward. Gimble supplies those basics without taking over the rest of the program.

Four terms

Run

One execution of a workflow and its record on disk.

Scope

A named piece of a run. It ends when its function returns.

Session

One agent conversation in one working directory.

Group

A named set of concurrent child scopes. Wait joins them.

Not an Attractor implementation

Gimble is a reaction to the work around Attractor, not an implementation of it. It does not adopt Attractor as its architecture, product plan, or vocabulary. The useful lesson kept here is simple: keep the workflow in code a person can read, and make the agent work observable.

Current boundary

The current product is the Go library and its run logs. This website is its short guide. A browser view for inspecting live and past runs is planned work, not something this page claims to provide today.

For the complete programming contract, use go doc -all github.com/tylergannon/gimble.