knit#

A CLI for tangled.sh

Installation#

Using go:

go install tangled.sh/rockorager.dev/knit/cmd/knit@latest

Otherwise,

git clone https://tangled.sh/rockorager.dev/knit
cd knit
make install

Usage#

knit has similar usage patterns as the Github CLI (gh). Prior to making any authenticated calls, you must authenticate with tangled.sh

knit auth login

This will require your ATProto handle and app password (the app password can be specific to knit). Knit will not store the password. Instead, knit authenticates with tangled.sh and stores the session cookie into your system keyring. Note to linux users: Your keyring must be setup for this to work properly

Authenticating will also create a default configuration file which maps a list of handles to a host. The first handle in the list is the default handle.

Creating repos#

To create a repo, run:

knit repo create

This will guide you through an interactive prompt to set up the repository. Currently, we can't request the configured knot servers for a given user - the only option is the default tangled.sh server