# 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