flora is a fast and secure runtime that lets you write discord bots for your servers, with a rich TypeScript SDK, without worrying about running infrastructure. [mirror]
1---
2outline: deep
3---
4
5# CLI
6
7:::info
8Currently the CLI is unpublished. It will be published soon as `@uwu/flora-cli`.
9:::
10
11The Flora CLI manages deployments, logs, and KV stores with the Flora Server API.
12
13## Login
14
15Generate a API Token at https://app.flora.uwu.network/settings and then login with:
16
17```bash
18flora login <token>
19```
20
21## Commands
22
23### Deploy
24
25To deploy to a guild:
26
27```bash
28flora deploy
29```
30
31- You can add `--guild [guildId]` to specify your guild (it prompts by default).
32- A positional arg to specify a custom entrypoint script is also provided if needed.
33- Using `--root path/to` allows you to specify a custom root (what gets packaged).
34
35### Get
36
37```bash
38flora get --guild 123456789012345678
39```
40
41### List
42
43```bash
44flora list
45```
46
47### Health
48
49```bash
50flora health
51```
52
53### Logs
54
55Fetch recent logs:
56
57```bash
58flora logs --guild 123456789012345678 --limit 100
59```
60
61Stream logs:
62
63```bash
64flora logs --guild 123456789012345678 --follow
65```
66
67### KV
68
69Create a store:
70
71```bash
72flora kv create-store --guild 123456789012345678 --name settings
73```
74
75List stores:
76
77```bash
78flora kv list-stores --guild 123456789012345678
79```
80
81Delete a store:
82
83```bash
84flora kv delete-store --guild 123456789012345678 --name settings
85```
86
87Set a value:
88
89```bash
90flora kv set --guild 123456789012345678 --store settings --key prefix "!"
91```
92
93Set with expiration and metadata:
94
95```bash
96flora kv set --guild 123456789012345678 --store settings --key session "{ \"user\": \"123\" }" \
97 --expiration 1735689600 --metadata "{\"source\":\"login\"}"
98```
99
100Get a value:
101
102```bash
103flora kv get --guild 123456789012345678 --store settings prefix
104```
105
106Delete a value:
107
108```bash
109flora kv delete --guild 123456789012345678 --store settings prefix
110```
111
112List keys:
113
114```bash
115flora kv list-keys --guild 123456789012345678 --store settings --prefix user: --limit 100
116```