close
Image aly.codes / tg
An unofficial terminal client for Tangled, optimized for humans and agents. tgcli.wisp.place
cli atproto go tangled
164
Fork 5

Configure Feed

Select the types of activity you want to include in your feed.

Go 89.3%
Python 8.0%
Nix 0.7%
JavaScript 0.6%
Astro 0.6%
Shell 0.3%
Just 0.3%
MDX 0.2%
TypeScript 0.1%
169 2 6

Clone this repository

https://tangled.org/aly.codes/tg https://tangled.org/did:plc:g5uweck3xar3m745g43giuhr
git@tangled.org:aly.codes/tg git@tangled.org:did:plc:g5uweck3xar3m745g43giuhr

For self-hosted knots, clone URLs may differ based on your setup.


Download tar.gz Download .zip
README.md

tg#

tg is a command-line client for Tangled, the git forge built on atproto. It is an analogue to the GitHub CLI (gh), using Bobbin for reads and authenticated PDS/knot writes.

Installation#

brew tap alyraffauf/tap
brew trust alyraffauf/tap
brew install alyraffauf/tap/tg

With Nix (latest dev release)#

nix profile add github:alyraffauf/tg

From source#

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

Quick start#

# Log in (OAuth, or pass an app password for headless use)
tg auth login alice.example.com

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

# Clone by repository DID
tg repo clone did:plc:example

# Work with issues and pull requests
tg issue list
tg issue create --body "Details" "Bug report"
tg pr create --title "Add feature" --base main
tg pr merge <rkey>

tg auto-detects the repository from Git remotes when run inside a cloned Tangled repo, checking origin first. It recognizes remotes that identify a repository by handle/repo or by repository DID. Hosted Tangled remotes support SSH, Git, HTTP, and HTTPS URLs. Custom Knot remotes support SSH and HTTPS URLs. tg verifies a custom Knot against the repository record before it accepts the remote.

When a repository record contains a repository DID, tg uses the DID in new Git remotes. Automatically selected Knots use the tangled.org proxy. An explicitly configured Knot uses a direct remote and the configured SSH port. These remotes remain valid after handle changes, repository renames, and transfers. If tg cannot resolve the repository record for an SSH clone, it creates a handle/repo remote and prints the resolution error as a warning.

MCP server#

The tgmcp package exposes Tangled tools to MCP clients. Run it from this checkout with nix run .#tgmcp. It uses tg from the same checkout.

Documentation#

  • Agent skill for using tg with a coding agent
  • Command reference — tg <command> --help, the man pages installed by the Nix package (man tg, man tg-issue-list, ...), or the website
  • Authentication — OAuth and app-password login, multiple accounts, keyring token storage
  • Configuration — config file, environment variables, and flags

Contributing#

See CONTRIBUTING.md for the development workflow and an overview of the codebase.

License#

See LICENSE.