starcite 0.0.2 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -39
- package/dist/index.js +489 -379
- package/dist/index.js.map +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -41,24 +41,16 @@ For temporary usage, use `npx starcite` or `bunx starcite` instead of installing
|
|
|
41
41
|
## Quick Start
|
|
42
42
|
|
|
43
43
|
```bash
|
|
44
|
-
starcite
|
|
44
|
+
starcite config set endpoint https://<your-instance>.starcite.io
|
|
45
|
+
starcite config set api-key <YOUR_API_KEY>
|
|
45
46
|
starcite create --id ses_demo --title "Draft contract"
|
|
46
47
|
starcite sessions list --limit 5
|
|
47
48
|
starcite append ses_demo --agent researcher --text "Found 8 relevant cases..."
|
|
48
|
-
starcite append ses_demo --agent drafter --text "Drafted section 2 with clause references."
|
|
49
49
|
starcite tail ses_demo --cursor 0 --limit 1
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
## Cloud Setup
|
|
53
53
|
|
|
54
|
-
```bash
|
|
55
|
-
starcite init
|
|
56
|
-
starcite config set endpoint https://<your-instance>.starcite.io
|
|
57
|
-
starcite auth login
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
Non-interactive alternative:
|
|
61
|
-
|
|
62
54
|
```bash
|
|
63
55
|
starcite config set endpoint https://<your-instance>.starcite.io
|
|
64
56
|
starcite config set api-key <YOUR_KEY>
|
|
@@ -67,9 +59,10 @@ starcite config set api-key <YOUR_KEY>
|
|
|
67
59
|
## Global Options
|
|
68
60
|
|
|
69
61
|
- `-u, --base-url <url>`: Starcite API base URL (highest precedence)
|
|
70
|
-
- `-k, --token <
|
|
62
|
+
- `-k, --token <key>`: Starcite API key (highest precedence)
|
|
71
63
|
- `--config-dir <path>`: Starcite CLI config directory (defaults to `~/.starcite`)
|
|
72
64
|
- `--json`: machine-readable JSON output
|
|
65
|
+
- `-v, --version`: show CLI version and exit
|
|
73
66
|
- `-h, --help`: show help text
|
|
74
67
|
|
|
75
68
|
Base URL resolution order:
|
|
@@ -87,6 +80,14 @@ API key resolution order:
|
|
|
87
80
|
|
|
88
81
|
## Commands
|
|
89
82
|
|
|
83
|
+
### `version`
|
|
84
|
+
|
|
85
|
+
Print the installed CLI version.
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
starcite version
|
|
89
|
+
```
|
|
90
|
+
|
|
90
91
|
### `create`
|
|
91
92
|
|
|
92
93
|
Create a session.
|
|
@@ -112,22 +113,6 @@ Useful flags:
|
|
|
112
113
|
- `--cursor <cursor>`: pagination cursor from previous result
|
|
113
114
|
- `--metadata <json>`: flat JSON object of exact-match metadata filters
|
|
114
115
|
|
|
115
|
-
### `init`
|
|
116
|
-
|
|
117
|
-
Initialize config for remote usage.
|
|
118
|
-
|
|
119
|
-
Behavior:
|
|
120
|
-
|
|
121
|
-
- writes endpoint to `~/.starcite/config.json`
|
|
122
|
-
- optionally stores API key
|
|
123
|
-
- supports interactive prompts when flags are omitted
|
|
124
|
-
|
|
125
|
-
Useful flags:
|
|
126
|
-
|
|
127
|
-
- `--endpoint <url>`: endpoint to store
|
|
128
|
-
- `--api-key <key>`: API key to save
|
|
129
|
-
- `-y, --yes`: skip prompts and use provided values only
|
|
130
|
-
|
|
131
116
|
### `config`
|
|
132
117
|
|
|
133
118
|
Manage local configuration.
|
|
@@ -144,18 +129,6 @@ Key aliases accepted by `config set`:
|
|
|
144
129
|
- producer id: `producer-id`, `producer_id`
|
|
145
130
|
- API key: `api-key`, `api_key`
|
|
146
131
|
|
|
147
|
-
### `auth`
|
|
148
|
-
|
|
149
|
-
Manage API key auth.
|
|
150
|
-
|
|
151
|
-
```bash
|
|
152
|
-
starcite auth login
|
|
153
|
-
starcite auth status
|
|
154
|
-
starcite auth logout
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
`auth login` supports `--api-key <key>` for non-interactive flows.
|
|
158
|
-
|
|
159
132
|
### `up`
|
|
160
133
|
|
|
161
134
|
Start local Starcite containers through an interactive wizard (Docker required).
|
|
@@ -239,3 +212,12 @@ starcite tail ses_demo --agent drafter --limit 5 --json
|
|
|
239
212
|
```
|
|
240
213
|
|
|
241
214
|
Press `Ctrl+C` to stop.
|
|
215
|
+
|
|
216
|
+
Useful flags:
|
|
217
|
+
|
|
218
|
+
- `--cursor <cursor>`: replay cursor (inclusive)
|
|
219
|
+
- `--agent <agent>`: filter to one `agent:<name>`
|
|
220
|
+
- `--limit <count>`: stop after N emitted events
|
|
221
|
+
- `--no-follow`: stop after replay instead of following live events
|
|
222
|
+
|
|
223
|
+
By default, `tail` requests batched replay frames from the API for faster catch-up.
|