-74

.agents/skills/tang/SKILL.md

Reviewed

··· 1 1 - --- 2 2 - name: tang 3 3 - description: | 4 4 - Use this skill when the user asks about this repo on Tangled, Tangled issues, 5 5 - Tangled pull requests, or Tangled operations. The current git remote is a 6 6 - Tangled repo, so `tang` can usually infer the repository from the worktree. 7 7 - --- 8 8 - 9 9 - # tang — Tangled repo workflow 10 10 - 11 11 - This repo packages [`tang`](https://tangled.org/onev.cat/tang) in `devenv`. 12 12 - Use it for Tangled operations. 13 13 - 14 14 - ## Repository selection 15 15 - 16 16 - Prefer the current git worktree. `tang` discovers the repo from `.git` remotes, 17 17 - so in this repo use commands without `--repo` / `-R` by default: 18 18 - 19 19 - ```bash 20 20 - tang status 21 21 - tang repo view 22 22 - tang issue list 23 23 - tang pr list 24 24 - ``` 25 25 - 26 26 - Only add `-R <owner>/<repo>` when the user explicitly asks about a different 27 27 - Tangled repo. 28 28 - 29 29 - ## Auth 30 30 - 31 31 - Reads often work without auth. Writes require login: 32 32 - 33 33 - ```bash 34 34 - bash .agents/skills/tang/auth.sh 35 35 - ``` 36 36 - 37 37 - The bootstrap uses `ATPROTO_HANDLE` / `ATPROTO_APP_PASSWORD`, falling back to 38 38 - `BSKY_HANDLE` / `BSKY_APP_PASSWORD`. App passwords are created at 39 39 - <https://bsky.app/settings/app-passwords>. Never use the main account password. 40 40 - 41 41 - ## Common commands for this repo 42 42 - 43 43 - ```bash 44 44 - # Inspect 45 45 - tang status 46 46 - tang repo view 47 47 - tang issue list 48 48 - tang issue view <number-or-rkey> 49 49 - tang pr list 50 50 - tang pr view <number-or-rkey> 51 51 - tang pr diff <number-or-rkey> 52 52 - 53 53 - # Issues 54 54 - tang issue create "Title" --body "Body" 55 55 - tang issue comment <number-or-rkey> --body "Comment" 56 56 - tang issue close <number-or-rkey> 57 57 - tang issue reopen <number-or-rkey> 58 58 - 59 59 - # Pull requests 60 60 - tang pr create --base main --head <branch> --title "Title" 61 61 - tang pr comment <number-or-rkey> --body "Comment" 62 62 - tang pr checkout <number-or-rkey> 63 63 - tang pr merge <number-or-rkey> --subject "Merge pull request #N" 64 64 - ``` 65 65 - 66 66 - ## Identifiers 67 67 - 68 68 - Numeric issue and PR IDs match Tangled web URLs. For raw protocol records, use 69 69 - `--atproto` with an AT URI, rkey, or unique rkey prefix. 70 70 - 71 71 - ## Safety 72 72 - 73 73 - Ask before performing writes against a different repo than the current worktree, 74 74 - or when auth is unavailable.

-37

.agents/skills/tang/auth.sh

Reviewed

··· 1 1 - #!/usr/bin/env bash 2 2 - # Bootstrap tang auth for agent use. 3 3 - # 4 4 - # Uses tang directly when available, otherwise runs it through devenv. 5 5 - # Logs in only when tang reports unauthenticated. 6 6 - 7 7 - set -euo pipefail 8 8 - 9 9 - run_tang() { 10 10 - if command -v tang >/dev/null 2>&1; then 11 11 - tang "$@" 12 12 - elif command -v devenv >/dev/null 2>&1; then 13 13 - devenv shell -- tang "$@" 14 14 - else 15 15 - echo "tang is not on PATH and devenv is unavailable" >&2 16 16 - exit 127 17 17 - fi 18 18 - } 19 19 - 20 20 - status="$(run_tang auth status --json 2>/dev/null || true)" 21 21 - if printf '%s\n' "$status" | grep -q '"authenticated"[[:space:]]*:[[:space:]]*true'; then 22 22 - printf '%s\n' "$status" 23 23 - exit 0 24 24 - fi 25 25 - 26 26 - : "${ATPROTO_HANDLE:=${BSKY_HANDLE:-}}" 27 27 - : "${ATPROTO_APP_PASSWORD:=${BSKY_APP_PASSWORD:-}}" 28 28 - 29 29 - if [ -z "${ATPROTO_HANDLE:-}" ] || [ -z "${ATPROTO_APP_PASSWORD:-}" ]; then 30 30 - echo "Not authenticated." >&2 31 31 - echo "Set ATPROTO_HANDLE / ATPROTO_APP_PASSWORD or BSKY_HANDLE / BSKY_APP_PASSWORD." >&2 32 32 - echo "Create an app password at https://bsky.app/settings/app-passwords" >&2 33 33 - exit 1 34 34 - fi 35 35 - 36 36 - export ATPROTO_HANDLE ATPROTO_APP_PASSWORD 37 37 - run_tang auth login --handle "$ATPROTO_HANDLE" <<< "$ATPROTO_APP_PASSWORD"