TICGIT DOCS AGENT INTEGRATION

Agent Integration

TicGit is designed to work with AI coding agents. Every command that reads or writes data supports --markdown output with next-step suggestions, so agents always know what to do next.

For agents: getting started

Run ti agent for a Markdown guide written for agents, covering the full command set with examples.

Reading tickets

Use --markdown to get structured output that includes ticket details and suggested next commands:

LIST
$ ti list --markdown
# Tickets
 
- Count: 11
 
## Overview
 
| Id | Title | Status | State | Assigned | Tags | Created |
| --- | --- | --- | --- | --- | --- | --- |
| `e70ac1` | Implement ti pull | `open` | `new` | | `feature` | 2026-05-10 |
| ...
 
## Next Commands
 
- `ti show e70ac1 --markdown` to inspect the first ticket.
SHOW
$ ti show e70 --markdown
# Ticket: Implement ti pull
 
## Details
 
- Id: `e70ac184-...`
- Status: `open`
- State: `new`
- Tags: `feature`
 
## Next Commands
 
- `ti checkout e70ac1` to make this the current ticket.
- `ti comment -t e70ac1 "progress"` to add a note.
- `ti close e70ac1` to resolve it.

Creating and updating tickets

Write commands also support --markdown, returning the updated ticket with next steps:

CREATE
$ ti new --title "fix the bug" --tags bug --markdown
# Ticket: fix the bug
 
## Details
- Id: `a3f29c84-...`
- Status: `open`
- Tags: `bug`
 
## Next Commands
- `ti checkout a3f` to make this the current ticket.
- `ti comment -t a3f "progress"` to add a note.
UPDATE
$ ti comment --ticket a3f "root cause identified" --markdown
$ ti state --ticket a3f in-progress --markdown
$ ti close a3f --markdown

Extract specific fields

Use --filter to pull out individual values:

FILTER
$ ti show a3f --filter .title
fix the bug
 
$ ti show a3f --filter .spec
Use RS256 tokens with 24h expiry...
 
$ ti show a3f --filter .tags
["bug"]

Typical agent workflow

WORKFLOW
# See what needs doing
$ ti list --markdown
 
# Pick a ticket and read it
$ ti show a3f --markdown
 
# Check out, work on it, leave notes
$ ti checkout a3f
$ ti comment "investigating root cause"
 
# Done — close it
$ ti close a3f --markdown