A terminal client for Tangled.
tui
go
tangled
cli
docs: document write commands and platform limits
Aly Raffauf
(Jul 15, 2026, 12:14 PM EDT)
53ab054c
4a6a4b6a
+29
-3
+29
-3
README.md
+29
-3
README.md
···
1
1
# tg
2
2
3
-
`tg` is a command-line client for [Tangled](https://tangled.org), the git forge built on atproto. It is an analogue to the GitHub CLI (`gh`), (for now) built against the read-only [Bobbin](https://docs.tangled.org/bobbin) XRPC API.
3
+
`tg` is a command-line client for [Tangled](https://tangled.org), the git forge built on atproto. It is an analogue to the GitHub CLI (`gh`), using Bobbin for reads and authenticated PDS/knot writes.
4
4
5
5
## Installation
6
6
···
50
50
51
51
# List issues for an explicit repository
52
52
tg issue list microcosm.blue/microcosm-rs
53
+
54
+
# Create, comment on, and update an issue
55
+
tg issue create --repo microcosm.blue/microcosm-rs --body "Details" "Bug report"
56
+
tg issue comment <rkey> --body "I can reproduce this"
57
+
tg issue close <rkey>
58
+
tg issue reopen <rkey>
59
+
tg issue edit <rkey> --title "Updated title"
53
60
```
54
61
55
62
### Pull Requests
···
58
65
# List pull requests
59
66
tg pr list
60
67
61
-
# Check out a pull request as detached HEAD
62
-
tg pr checkout 3mporttfqez22
68
+
# Create, comment on, inspect, and update pull requests
69
+
tg pr create --title "Add feature" --base main
70
+
tg pr diff <rkey>
71
+
tg pr comment <rkey> --body "Looks good"
72
+
tg pr close <rkey>
73
+
tg pr merge <rkey>
63
74
```
75
+
76
+
### Other commands
77
+
78
+
`tg repo edit`, `tg repo set-default-branch`, `tg repo delete --yes`, `tg repo fork`,
79
+
`tg ssh-key delete`, `tg browse`, `tg completion`, `tg auth token`, and `tg api` are available.
80
+
81
+
Changing scopes requires existing users to run `tg auth login` again.
82
+
83
+
## Platform limits
84
+
85
+
Tangled currently has no API for releases, gists, workflows/runs, repository archive/sync/rename,
86
+
PR checks, projects, codespaces, a status dashboard, or global text search. `tg pr checkout` is
87
+
deferred until PRs expose an immutable base commit/ref, allowing a safe isolated-worktree
88
+
implementation. `auth switch` is deferred because the local auth store currently supports one
89
+
account.
64
90
65
91
## Architecture
66
92