A CLI for tangled.sh
rockorager.dev
1# knit
2
3A CLI for tangled.sh
4
5## Installation
6
7`go install tangled.sh/rockorager.dev/knit`
8
9## Usage
10
11`knit` has similar usage patterns as the Github CLI (`gh`). Prior to making any
12authenticated calls, you must authenticate with tangled.sh
13
14```
15knit auth login
16```
17
18This will require your ATProto handle and app password (the app password can be
19specific to knit). Knit will *not* store the password. Instead, knit
20authenticates with tangled.sh and stores the session cookie into your system
21keyring. Note to linux users: Your keyring *must be setup* for this to work
22properly
23
24Authenticating will also create a default configuration file which maps a list
25of handles to a host. The first handle in the list is the default handle.
26
27### Creating repos
28
29To create a repo, run:
30
31```
32knit repo create
33```
34
35This will guide you through an interactive prompt to set up the repository.
36Currently, we can't request the configured knot servers for a given user - the
37only option is the default tangled.sh server