Skip to main content
Version: 0.3

Changelog

What's new in gest — told version by version.

v0.3.5

2026-03-31

Task Notes

Tasks can now carry threaded notes with author attribution. Human authors are identified automatically from your git config, and agent-authored notes are tagged with --agent. Each note includes a timestamp and renders its body as markdown.

  • Add, list, show, update, and delete notes via gest task note subcommands
  • Notes appear in task show output and on the web UI task detail page
  • Gravatar avatars and agent badges distinguish human from machine authors

Iteration Orchestration

New commands make it easier to drive multi-phase work through an iteration without manually juggling task status.

  • iteration status shows progress at a glance
  • iteration next peeks at or claims the next available task
  • iteration advance signals that a phase is complete
  • task list --assigned-to narrows results by assignee
  • iteration list --has-available finds iterations with claimable work
  • gest search now includes iterations in its results

v0.3.4

2026-03-31

Security

ID prefix validation now rejects invalid characters, closing a potential path injection vector via crafted entity IDs.

v0.3.3

2026-03-31

Web UI Forms

The web UI gained create and edit forms for tasks and artifacts, complete with markdown preview, relationship management, and inline search — so you can manage your project without leaving the browser.

  • Dashboard status cards now link directly to filtered task views
  • New/edit buttons on list and detail pages for quick navigation

Display Improvements

Short ID prefixes are now clickable links throughout the web UI. Tags are clickable for quick filtering, and artifact type labels are used consistently across all views.

Bug Fixes

  • Store writes now respect whether an entity lives in the active or archive/resolved directory, preventing duplicates on mutation
  • CLI flags (--version, --verbose) and shell completion variants now include help text (#24)

v0.3.2

2026-03-31

Built-in Web Server

gest serve launches a local web UI with a dashboard, task/artifact/iteration views, a kanban board, and full-text search — everything you need to browse your project visually (#13#23).

  • --port, --bind, and --no-open flags control the local server (#15)
  • [serve] config section with port, bind_address, and open settings (#14)

Performance

  • Iteration phase counts are now cached instead of recomputed on every read
  • resolve_dot_path walks by reference instead of cloning, reducing allocations
  • Shared helpers consolidated across store operations, CLI metadata handling, and tag/untag commands

Bug Fixes

  • Multi-word EDITOR values (e.g. code --wait) are now parsed correctly via shell tokenization
  • Nested metadata set_nested is bounds-checked with a depth limit to prevent stack overflows
  • Version line no longer appears in the --help banner
  • gest search --expand now shows full content instead of truncated snippets (#11)

v0.3.1

2026-03-30

Per-Entity Directory Overrides

You can now control where each entity type is stored on disk via GEST_ARTIFACT_DIR, GEST_TASK_DIR, and GEST_ITERATION_DIR environment variables — or the corresponding storage.*_dir config fields.

Performance

  • Blocked-by status resolution for task lists now uses a single batched read pass instead of per-task I/O
  • Search filtering avoids redundant string allocations during case-insensitive matching
  • Prefix matching exits early after two matches instead of collecting all candidates
  • Metadata serialization is skipped during search when maps are empty
  • Store functions receive the full application config, removing the need for plumbing changes when new settings are accessed

v0.3.0

2026-03-30

Breaking Changes

This release includes two breaking changes:

  • TOML-only configuration. JSON and YAML config files are no longer supported. Rename your config to gest.toml and convert the contents to TOML.
  • Global store by default. gest init now creates the global data store. Use gest init --local if you want an in-repo .gest/ directory.

New UI

The entire terminal UI has been rebuilt with an atomic architecture (atoms, composites, views) for consistent, aligned rendering across all commands.

v0.2.3

2026-03-29

Iterations

A new entity type for planning multi-phase work. Iterations have their own storage, UI components, CLI commands, and a graph visualization that shows how tasks flow through phases.

Richer Task Fields

Tasks now support priority, assigned_to, and phase fields for more structured project tracking.

Search Improvements

--expand on gest search now works without --json, showing full detail blocks directly in the terminal.

v0.2.2

2026-03-27

Update Notifications

gest version now checks for newer releases and suggests gest self-update when one is available.

Search Improvements

The --expand (-e) flag on gest search enriches --json output with full item details.

Theme Tokens

New indicator.blocked and indicator.blocking theme tokens let you customize how task list status indicators look.

Performance

Reduced unnecessary memory allocations in UI rendering and search, plus extracted shared helpers and removed dead code.

v0.2.1

2026-03-26

Bug Fixes

  • Install script now downloads the correct checksum file during installation
  • Self-update no longer fails with a 404 when fetching the target release

v0.2.0

2026-03-26

Shell Completions and Man Pages

New generation commands produce shell completions and man pages for your preferred shell (#1).

Markdown Rendering

Descriptions are no longer plain text in the terminal. Headings, code blocks, lists, blockquotes, and more are rendered with styled formatting (#2, #3). Artifact and task detail views use this automatically (#4, #5).

Verbose Logging

Every command, store operation, and config discovery step now emits verbose logs for easier debugging.

Breaking Change

artifact list --include-archived has been renamed to --all (-a), matching the convention used by task and search commands.

Performance

Faster unique ID prefix computation and shorter ID encoding.

Bug Fixes

Log level semantics now correctly follow the debug=why, trace=result convention.

v0.1.0

2026-03-26

The first release of gest — a lightweight CLI for tracking AI-agent-generated tasks and artifacts alongside your project. Ships with artifact and task commands, TOML/JSON/YAML configuration, search, and editor integration.