TICGIT DOCS VIEWS & IMPORT

Views and Import

Commands: ti views, ti stats, ti import

Saved views

Views save the filters from your last ti list command so you can replay them by name. They store the filter criteria, not a snapshot of ticket IDs — so new tickets matching the filters will appear automatically.

Create a view

First run ti list with the filters you want, then save them:

SAVE VIEW

$ ti list --tag bug
  a3f29c 2d    fix parser panic         open  new         bug
  d91c3a 5d    null pointer in export   open  assigned    bug
 
$ ti views save bugs
Saved view `bugs`: --tag bug

Use a view

LIST BY VIEW

$ ti list bugs
  a3f29c 2d    fix parser panic         open  new         bug
  d91c3a 5d    null pointer in export   open  assigned    bug

List saved views

LIST VIEWS

$ ti views
  bugs --tag bug
  my-work --assigned alice@example.com
  blocked --state blocked

Delete a view

DELETE VIEW

$ ti views delete bugs

Deleted view `bugs`.

Stats dashboard

Get an overview of your project's tickets with ti stats:

STATS

$ ti stats
────────────────────────────────────────────────
  TICGIT STATS
────────────────────────────────────────────────
 
  Overview     27 ticket(s), 8 with comments
  Open         22          Closed  5
 
  States
    new          14  ████████████████████
    in-progress   6  ████████
    resolved      5  ███████
 
  Top Tags
    feature      12  ████████████████████
    bug           8  █████████████
    agent         4  ██████
 
────────────────────────────────────────────────

Machine-readable output:

JSON

$ ti stats --json

Import from GitHub

Pull open issues from a GitHub repository into TicGit. Requires the GitHub CLI (gh).

GITHUB IMPORT

$ ti import gh --repo owner/repo
Imported 12 ticket(s) from owner/repo
  a3f29c  fix parser panic on empty input
  d91c3a  null pointer in CSV export
  7b2e4f  crash on large input files
  ... and 9 more

What gets imported:

Issue title becomes the ticket title
Issue body, GitHub URL, author, and assignees go into the description
Issue labels become tags (plus github and github-issue)
First GitHub assignee becomes the ticket assignee
Issue milestone becomes the ticket milestone

Limit the import

OPTIONS

$ ti import gh --repo owner/repo --limit 50

$ ti import gh --repo owner/repo --json

Import from Linear

Pull issues from a Linear team into TicGit. Requires a Linear API key (set LINEAR_API_KEY in your environment).

LINEAR IMPORT

$ ti import linear --team ENG

Imported issues from Linear team ENG.

Omit --team to list available teams:

LIST TEAMS

$ ti import linear