runtime-cli 0.1.0

Command-line client for managing git projects on Runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# Runtime CLI

The Runtime CLI installs a `runtime` command for managing git projects on the
hosted Runtime service at `https://gitruntime.com`.

## Install

```bash
cargo install runtime-cli
```

Then invoke it directly:

```bash
runtime auth login --username alice
runtime repo list
runtime issue list alice/project
runtime pr view alice/project 1
```

`runtime auth login` defaults to `https://gitruntime.com`, so most users only
need a username and password. To connect to a self-hosted instance instead,
pass `--host` or set `RUNTIME_HOST`:

```bash
runtime auth login --host https://runtime.example --username alice
```

The CLI stores a personal access token in `~/.config/runtime/config.json` with
mode `0600` on Unix systems. TOTP-enabled accounts are not supported by
interactive CLI login yet; create a PAT from another Runtime client and write
that token into the config file when second-factor auth is required.

## Common commands

```bash
runtime repo list
runtime repo clone alice/project
runtime issue create alice/project --title "Bug" --body "Steps to reproduce"
runtime pr create alice/project --title "Ship it" --head feature --base main
runtime run list alice/project
runtime api 'query { viewer { username } }'
```

The package name is `runtime-cli`; the installed binary is `runtime`.