Gest
Manage agent-generated artifacts and task backlogs alongside your project.
[!WARNING] Gest is in early development. Commands, file formats, and configuration may change without notice between releases.
Gest is a CLI tool for tracking tasks and artifacts generated during AI-assisted development. Data is stored as plain
files — TOML for tasks, Markdown with YAML frontmatter for artifacts — and can live inside your repo (.gest/) or in an
external data directory.
Quick Start
Commands
| Command | Description |
|---|---|
gest init |
Initialize gest in the current directory |
gest task |
Create, list, show, update, tag, link, and manage tasks |
gest artifact |
Create, list, show, update, tag, archive, and manage artifacts |
gest search |
Search across tasks and artifacts |
gest config |
View and modify configuration |
Run gest --help or gest <command> --help for full details.
Configuration
Gest loads configuration from global (~/.config/gest/) and project-level files, supporting TOML, JSON, and YAML
formats. Run gest config show to see the resolved configuration and its source files.
Installation
Quick Install (macOS and Linux)
|
[!TIP] This installs
doingto~/.local/bin. Make sure it's in yourPATH:
Pin a specific version or change the install directory:
GEST_VERSION=0.0.1 GEST_INSTALL_PATH=/usr/local/bin \
|
Cargo
Or with cargo-binstall for a pre-built binary:
Status
Early development. See docs for design documents and process guides.