gest 0.2.0

Manage agent-generated artifacts and task backlogs alongside your project
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# Gest

[![Build][build-badge]][build-link]
[![Crates.io Version][crates-badge]][crates-link]
[![GitHub Sponsors][sponsor-badge]][sponsor-link]

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

```sh
gest init
gest task create "Implement auth middleware"
gest artifact create --file auth-spec.md
gest search "auth"
```

## 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)

```sh
curl -fsSL https://raw.githubusercontent.com/aaronmallen/gest/main/script/install.sh | sh
```

> [!TIP]
> This installs `doing` to `~/.local/bin`. Make sure it's in your `PATH`:
>
>```sh
>export PATH="$HOME/.local/bin:$PATH"
>```

Pin a specific version or change the install directory:

```sh
GEST_VERSION=0.0.1 GEST_INSTALL_PATH=/usr/local/bin \
  curl -fsSL https://raw.githubusercontent.com/aaronmallen/gest/main/script/install.sh | sh
```

### Cargo

```sh
cargo install gest
```

Or with [cargo-binstall] for a pre-built binary:

```sh
cargo binstall gest
```

## Status

Early development. See [docs] for design documents and process guides.

## License

[MIT]

[build-badge]:
  https://img.shields.io/github/actions/workflow/status/aaronmallen/gest/build.yml?branch=main&style=for-the-badge
[build-link]: https://github.com/aaronmallen/gest/actions/workflows/build.yml
[cargo-binstall]: https://github.com/cargo-bins/cargo-binstall
[crates-badge]: https://img.shields.io/crates/v/gest?style=for-the-badge
[crates-link]: https://crates.io/crates/gest
[docs]: https://github.com/aaronmallen/gest/tree/main/docs
[MIT]: https://github.com/aaronmallen/gest/blob/main/LICENSE
[sponsor-badge]: https://img.shields.io/github/sponsors/aaronmallen?style=for-the-badge
[sponsor-link]: https://github.com/sponsors/aaronmallen