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