quinjet 0.0.47

A fast, live, keyboard-first Git source-control interface for the terminal
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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

# `quinjet worktree list`

Prints every Git worktree attached to this repository.

Usage:

```bash
quinjet worktree list [-C <DIR>] [--json]
```

Arguments:

| Name | Type / values | Default | What it does |
| --- | --- | --- | --- |
| none | | | `list` takes no positional argument. |

Options:

| Name | Type / values | Default | What it does |
| --- | --- | --- | --- |
| `-C, --path <DIR>` | path | `.` | The repository to read. Global; a subdirectory or a linked worktree resolves to that tree's root. |
| `--json` | flag | off | Prints one JSON array on stdout instead of the table. |
| `-h, --help` | flag | off | Prints this verb's help on stdout and exits 0. |

There is no filter, no `--all` and no `--watch`. The whole worktree list is
read every time.

One Git call reads the worktree records:

```bash
git worktree list --porcelain -z
```

A second, batched read resolves the listed HEADs without walking history:

```bash
git log --no-walk=unsorted --ignore-missing --format=%H%x1f%cI%x1f%ct%x1e <HEADS...>
```

If a stale or incomplete worktree names a commit Git cannot resolve, the
listing remains available and that worktree has no update time.

Records are separated by an extra NUL, fields by a single NUL. The fields
Quinjet keeps are `worktree <path>`, `HEAD <oid>`, `branch <ref>`, `detached`,
`bare`, `locked [reason]` and `prunable [reason]`. A record without a
`worktree` path is skipped. The branch field is stored without the
`refs/heads/` prefix.

`current` is true when that path is the same worktree the session opened,
compared after canonicalizing both sides when the filesystem allows it.
Opening the listing from a linked tree therefore marks that tree, not the
main checkout.

The text form is one row per worktree:

```text
* /path/to/main     main              abcdef01  2 minutes ago
  /path/to/topic    topic             fedcba98  3 days ago
  /path/to/hotfix   detached          01234567  prunable  14 days ago
```

The first column is `*` for this session and a space otherwise. The path is
unquoted. The branch column is the short name, `detached`, `bare`, or `-` when
Git reported none of those. A locked or prunable tree gets that word appended.
The final value is the HEAD commit's relative age when that commit was
resolved.

An empty extra listing is not a failure: a repository with only its main tree
prints one row and exits 0, and `--json` prints a one-element array.

`--json` shape, an array of objects, one per worktree, in Git's order (main
tree first):

```json
[
  {
    "path": "/tmp/repo",
    "head": "abcdef0123456789",
    "updatedAt": "2026-08-22T17:58:00Z",
    "branch": "main",
    "current": true,
    "bare": false,
    "detached": false,
    "locked": null,
    "prunable": null
  },
  {
    "path": "/tmp/repo-topic",
    "head": "fedcba9876543210",
    "updatedAt": "2026-08-19T17:58:00Z",
    "branch": "topic",
    "current": false,
    "bare": false,
    "detached": false,
    "locked": null,
    "prunable": null
  }
]
```

`locked` and `prunable` are strings when Git supplied a reason, an empty
string when the flag is present without a reason, and `null` when it is
absent. `branch` is `null` for a detached or bare tree. `updatedAt` is the
strict ISO commit time, or `null` when the listed HEAD could not be resolved.

The command line does not switch Quinjet onto another tree. In the terminal
interface, Enter on a row in Recent projects rebinds this session to that
path, which is the same as `quinjet tui <path>`.