# tangled-cli

This directory contains the Nix package for `tang`, a command-line client for [Tangled](https://tangled.org).

Source: [`tangled.org/onev.cat/tang`](https://tangled.org/onev.cat/tang)

## Usage

```bash
tang --help
tang version

# Auth using an ATProto app password · cf https://bsky.app/settings/app-passwords
tang auth status
tang auth login --handle mykiwi.dev
tang auth refresh
tang auth token --json

# Inspect Tangled state without leaving the terminal
tang status
tang repo list mykiwi.dev --json
tang repo view -R mykiwi.dev/sandbox --json
tang issue list -R mykiwi.dev/sandbox --json
tang pr list -R mykiwi.dev/sandbox --json

# Work from current git repo, or override with -R / --repo
tang repo view
tang issue list
tang pr list
tang issue list -R onev.cat/tang
tang pr view 1 -R onev.cat/tang

# Clone repositories
tang repo clone onev.cat/tang
tang repo clone onev.cat/tang .spokes/tang
tang config set clone.protocol ssh   # use SSH for OWNER/REPO clones
tang config set clone.protocol https # default

# Issues
tang issue create "Bug in X" --body "Details..."
tang issue view 1
tang issue comment 1 --body "Fixed in v1.2"
tang issue edit 1 --title "Better title"
tang issue close 1
tang issue reopen 1

# Pull requests
git push origin feature/foo
tang pr create --base main --head feature/foo --title "Add foo support"
tang pr view 1
tang pr diff 1
tang pr comment 1 --body "LGTM"
tang pr checkout 1
tang pr close 1
tang pr reopen 1
tang pr merge 1 --subject "Merge pull request #1"

# Browser helpers
tang browse
tang browse issue 1
```

Numeric issue and pull request IDs match Tangled web URLs. Use `--atproto` with an AT URI, rkey, or unique rkey prefix for raw protocol records.