···11-# Tangled CLI: Architecture & Implementation Plan
11+# tang
22+33+A CLI for [Tangled.org](https://tangled.org) — manage issues and repository context from the terminal. Designed to be usable by both humans and AI agents.
44+55+## Installation
66+77+```bash
88+npm install -g @markbennett/tang
99+```
1010+1111+## Quick Start
1212+1313+```bash
1414+# Authenticate with your Tangled PDS handle and an App Password
1515+tang auth login
1616+1717+# From inside a git repo cloned from tangled.org:
1818+tang issue list
1919+tang issue create "Bug: something is broken" --body "Detailed description"
2020+tang issue view 1
2121+tang issue close 1
2222+2323+# SSH key management
2424+tang ssh-key add ~/.ssh/id_ed25519.pub
2525+```
2626+2727+## Commands
2828+2929+| Command | Description |
3030+| :--- | :--- |
3131+| `tang auth login` | Authenticate with your PDS handle and App Password |
3232+| `tang auth logout` | Log out and clear stored session |
3333+| `tang issue list` | List issues for the current repo |
3434+| `tang issue create <title>` | Create a new issue |
3535+| `tang issue view <n>` | View an issue |
3636+| `tang issue close <n>` | Close an issue |
3737+| `tang issue reopen <n>` | Reopen an issue |
3838+| `tang ssh-key add <path>` | Upload a public SSH key to your account |
3939+| `tang context` | Show resolved repo context (DID, handle, name) |
4040+| `tang config` | View or set CLI configuration |
4141+4242+Most commands accept `--json [fields]` for machine-readable output, useful for scripting and LLM integrations.
4343+4444+---
24533-## Project Overview
4646+# Architecture & Implementation Notes
447548**Goal:** Create a context-aware CLI for tangled.org that bridges the gap between the AT Protocol (XRPC) and standard Git.
649···228271229272# Install globally for local testing
230273npm link
231231-tangled --version
232232-tangled --help
233233-npm unlink -g tangled-cli # Unlink when done
274274+tang --version
275275+tang --help
276276+npm unlink -g @markbennett/tang # Unlink when done
234277```
235278236279### Project Structure