Authentication (auth)
- login - Authenticate with AT Protocol credentials
- status - Show current authentication status
- logout - Clear stored session
Repositories (repo)
- list - List your repositories or another user's repos
- create - Create a new repository on a knot
- clone - Clone a repository to your local machine
- info - Show detailed repository information
- delete - Delete a repository
- star / unstar - Star or unstar repositories
Issues (issue)
- list - List issues for a repository
- create - Create a new issue
- show - Show issue details and comments
- edit - Edit issue title, body, or state
- comment - Add a comment to an issue
Pull Requests (pr)
- list - List pull requests for a repository
- create - Create a pull request from a branch
- show - Show pull request details and diff
- review - Review a pull request (approve/request changes)
- merge - Merge a pull request
Knot Management (knot)
- migrate - Migrate a repository to another knot
CI/CD with Spindle (spindle)
- config - Enable/disable or configure spindle for a repository
- list - List pipeline runs for a repository
- logs - Stream logs from a workflow execution
- secret - Manage secrets for CI/CD workflows
  - list - List secrets for a repository
  - add - Add or update a secret
  - remove - Remove a secret
- run - Manually trigger a workflow (not yet implemented)

Installation#

Build from Source#

Requires Rust toolchain (1.70+) and network access to fetch dependencies.

cargo build --release

The binary will be available at target/release/tangled-cli.

Install from AUR (Arch Linux)#

Community-maintained package:

yay -S tangled-cli-git

Quick Start#

Login to Tangled:

tangled auth login --handle your.handle.bsky.social

List your repositories:
```
tangled repo list
```

Create a new repository:

tangled repo create myproject --description "My cool project"

Clone a repository:
```
tangled repo clone username/reponame
```

Workspace Structure#

crates/tangled-cli - CLI binary with clap-based argument parsing
crates/tangled-config - Configuration and session management (keyring-backed)
crates/tangled-api - XRPC client wrapper for AT Protocol and Tangled APIs
crates/tangled-git - Git operation helpers

Configuration#

The CLI stores session credentials securely in your system keyring and configuration in:

Linux: ~/.config/tangled/config.toml
macOS: ~/Library/Application Support/tangled/config.toml
Windows: %APPDATA%\tangled\config.toml

Environment Variables#

TANGLED_PDS_BASE - Override the PDS base URL (default: https://bsky.social)
TANGLED_API_BASE - Override the Tangled API base URL (default: https://tngl.sh)
TANGLED_SPINDLE_BASE - Override the Spindle base URL (default: wss://spindle.tangled.sh)

Examples#

Working with Issues#

# Create an issue
tangled issue create --repo myrepo --title "Bug: Fix login" --body "Description here"

# List issues
tangled issue list --repo myrepo

# Comment on an issue
tangled issue comment <issue-id> --body "I'll fix this"

Working with Pull Requests#

# Create a PR from a branch
tangled pr create --repo myrepo --base main --head feature-branch --title "Add new feature"

# Review a PR
tangled pr review <pr-id> --approve --comment "LGTM!"

# Merge a PR
tangled pr merge <pr-id>

CI/CD with Spindle#

# Enable spindle for your repo
tangled spindle config --repo myrepo --enable

# List pipeline runs
tangled spindle list --repo myrepo

# Stream logs from a workflow
tangled spindle logs knot:rkey:workflow-name --follow

# Manage secrets
tangled spindle secret add --repo myrepo --key API_KEY --value "secret-value"
tangled spindle secret list --repo myrepo

Development#

Run tests:

cargo test

Run with debug output:

cargo run -p tangled-cli -- --verbose <command>

Format code:

cargo fmt

Check for issues:

cargo clippy

Contributing#

Contributions are welcome! Please feel free to submit issues or pull requests.

License#

MIT OR Apache-2.0

Clone this repository