v0.5.0

Changelog

• 6151189 feat: temporal management - backdate, edit, import/export (v0.5.0)
• 8b621be fix: resolve lint errors (errcheck, unused, gofmt, misspell)
• c21b14a fix: resolve lint errors for v0.5.0 release

v0.1.0

beats v0.1.0

Narrative substrate for beads. Capture insights, discoveries, and reflections that feed into actionable work.

Installation

One-liner (macOS/Linux):

curl -sL https://raw.githubusercontent.com/bierlingm/beats/main/install.sh | sh

With Go:

go install github.com/bierlingm/beats/cmd/beats@latest

Manual download:
Download the appropriate archive below for your OS/architecture, extract, and move beats to your PATH.

Quick Start

# Add a beat
beats add "Insight from today: simplicity compounds"

# List all beats
beats list

# Search
beats search "simplicity"

# Link a beat to a bead (if using beads)
beats link beat-20251211-001 mb-abc

What is beats?

Beats are the "why" and context. Beads are the "what" (actionable work).

A beat is a minimally structured narrative unit—an insight, discovery, or reflection. Beats accumulate as raw material. When a beat becomes actionable, it promotes to a bead and the beat remains as narrative context.

Documentation

See the README for full documentation.