ticgit field manual

CHAPTER ZERO · ABSTRACT

ticgit: issue tracking in git.

ticgit is a distributed issue system that stores tickets as metadata using the<br>git meta<br>toolkit. it does not run a server. it does not require a proprietary web<br>application. it does not have downtime. it synchronises issue data using the<br>same protocol you already use to move source code.

§ 4.0 — FIELD MANUAL PROCEDURES

PROC 01 — INSTALL

SCRIPT

curl -fsSL https://ticgit.dev/install | sh

CARGO

cargo install ticgit

$ti --version

ticgit 0.3.1

PROC 02 — TRY IT

$ti new --title "fix oauth redirect" --tags bug

Created ticket a3f29c (fix oauth redirect)

$ti list

a3f29c 0d fix oauth redirect open new bug

b81e04 1d update onboarding copy open assigned docs

$ti close a3f

Closed a3f29c.

PROC 03 — GIVE IT TO AN AGENT

Agent Prompt

run `ti agent` to learn ticgit, then find the<br>next ticket, fix it and close it

PROC 04 — SYNC YOUR TEAM

$ti sync

Remote: origin

Ref: refs/meta/main

URL: git@github.com:team/project.git

Pull: 3 new ticket(s)

Push: 12 ticket(s) synced.

Done.

VERSION

0.3.1

LICENSE

MIT

BINARY

~7 MB

PLATFORMS

mac · linux · win

Machine output schema

TicGit publishes a stable JSON schema for agent and automation<br>workflows. Use it when parsing ti show --json, JSON<br>mutation output, or ti list --json.

Download schema v1 or read the<br>agent-friendly Markdown site at docs/index.md.

ti show --json emits a ticket object.<br>ti list --json emits an array of ticket objects. Ticket<br>metadata appears under .meta as string values.

Tickets include status (open or<br>closed) and state. Open states are<br>new, assigned, in-progress,<br>blocked, and review. Closed states are<br>resolved, wontfix, duplicate,<br>and invalid.

--json is the stable machine interface: successful<br>commands write parseable JSON to stdout only, diagnostics go to<br>stderr, JSON output has no ANSI color escapes, and failures return a<br>non-zero exit status.

Ticket ids may be full UUIDs or unique UUID prefixes. Ambiguous or<br>missing prefixes fail with a stderr diagnostic.

--porcelain and --format json are not<br>supported compatibility aliases today; use --json.