tg#

tg is a command-line client for Tangled, the git forge built on atproto. It is an analogue to the GitHub CLI (gh), (for now) built against the read-only Bobbin XRPC API.

Installation#

With Nix#

nix profile add github:alyraffauf/tg

From source#

go install github.com/alyraffauf/tg/cmd/tg@latest

Usage#

tg auto-detects the repository from the origin remote when run inside a cloned Tangled repo. For now, only ssh origins are supported. You can also pass a fully-qualified handle/repo argument.

Repositories#

# List repositories for a user
tg repo list microcosm.blue

# Create a repository (requires `tg auth login`)
tg repo create my-tool --description "A small tool"

# Create and clone it into the current directory
tg repo create my-tool --clone

# Create and push an existing local repo (at the given path) to the new remote
tg repo create my-tool --push=.

# Clone a repository
tg repo clone microcosm.blue/microcosm-rs

# Clone into a custom directory
tg repo clone microcosm.blue/microcosm-rs my-fork

Issues#

# List issues for the current repository
tg issue list

# List issues for an explicit repository
tg issue list microcosm.blue/microcosm-rs

Pull Requests#

# List pull requests
tg pr list

# Check out a pull request as detached HEAD
tg pr checkout 3mporttfqez22

Architecture#

cmd/tg/ — CLI entry point
internal/cli/ — Cobra command tree (repo, issue, pr)
internal/gitutil/ — Git operations (clone, fetch, patch apply)
tangled/ — Typed client for the Bobbin API (api.tangled.org)
atproto/ — Identity resolution (handle ↔ DID, PDS discovery)

Dependencies#

Go 1.26+
git and ssh (for clone and PR checkout)
github.com/bluesky-social/indigo — atproto SDK
github.com/spf13/cobra — CLI framework

License#

See LICENSE.

Configure Feed