xevol 0.11.16 → 0.11.18

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.
Files changed (4) hide show
  1. package/README.md +84 -45
  2. package/dist/bin.js +3 -0
  3. package/dist/index.js +217 -285
  4. package/package.json +8 -4
package/README.md CHANGED
@@ -37,6 +37,12 @@ Or run without installing:
37
37
  npx xevol
38
38
  ```
39
39
 
40
+ or install with brew:
41
+
42
+ ```bash
43
+ brew install xevol/tap/xevol
44
+ ```
45
+
40
46
  Requires Node.js 18+.
41
47
 
42
48
  ## Quick Start
@@ -57,19 +63,20 @@ xevol view <id>
57
63
 
58
64
  ## Commands
59
65
 
60
- | Command | Description |
61
- |---------|-------------|
62
- | `login` | Authenticate via device flow (opens browser) |
63
- | `logout` | Clear stored credentials |
64
- | `whoami` | Show current user, plan, and usage |
65
- | `add` | Add a YouTube URL for transcription |
66
- | `list` | List your transcriptions |
67
- | `view` | View a transcription summary or full transcript |
68
- | `analyze` | Generate AI analysis using a prompt |
69
- | `prompts` | List available analysis prompts |
70
- | `stream` | Stream analysis output via SSE |
71
- | `resume` | Resume a previous streaming session |
72
- | `config` | View or edit CLI configuration |
66
+ | Command | Description |
67
+ | --------- | ----------------------------------------------- |
68
+ | `login` | Authenticate via device flow (opens browser) |
69
+ | `logout` | Clear stored credentials |
70
+ | `whoami` | Show current user, plan, and usage |
71
+ | `add` | Add a YouTube URL for transcription |
72
+ | `list` | List your transcriptions |
73
+ | `locations` | List your Xevol Coordinates location history |
74
+ | `view` | View a transcription summary or full transcript |
75
+ | `analyze` | Generate AI analysis using a prompt |
76
+ | `prompts` | List available analysis prompts |
77
+ | `stream` | Stream analysis output via SSE |
78
+ | `resume` | Resume a previous streaming session |
79
+ | `config` | View or edit CLI configuration |
73
80
 
74
81
  All commands support `--json` for machine-readable output.
75
82
 
@@ -114,13 +121,13 @@ xevol add "https://youtube.com/watch?v=abc123" --analyze facts,advice
114
121
  xevol add "https://youtube.com/watch?v=abc123" --analyze facts --stream
115
122
  ```
116
123
 
117
- | Flag | Description |
118
- |------|-------------|
119
- | `--no-wait` | Return immediately without waiting |
120
- | `--lang <code>` | Language code (e.g. `en`, `de`, `ja`) |
124
+ | Flag | Description |
125
+ | --------------------- | ----------------------------------------------------- |
126
+ | `--no-wait` | Return immediately without waiting |
127
+ | `--lang <code>` | Language code (e.g. `en`, `de`, `ja`) |
121
128
  | `--analyze <prompts>` | Comma-separated prompt IDs to run after transcription |
122
- | `--stream` | Stream analysis output via SSE |
123
- | `--json` | JSON output |
129
+ | `--stream` | Stream analysis output via SSE |
130
+ | `--json` | JSON output |
124
131
 
125
132
  ### `xevol list`
126
133
 
@@ -141,13 +148,45 @@ xevol list --json
141
148
  xevol list --csv
142
149
  ```
143
150
 
144
- | Flag | Description |
145
- |------|-------------|
146
- | `--page <n>` | Page number |
147
- | `--limit <n>` | Results per page |
151
+ | Flag | Description |
152
+ | -------------- | ---------------- |
153
+ | `--page <n>` | Page number |
154
+ | `--limit <n>` | Results per page |
148
155
  | `--status <s>` | Filter by status |
149
- | `--json` | JSON output |
150
- | `--csv` | CSV output |
156
+ | `--json` | JSON output |
157
+ | `--csv` | CSV output |
158
+
159
+ ### `xevol locations`
160
+
161
+ List your location history from Xevol Coordinates.
162
+
163
+ ```bash
164
+ # Default view
165
+ xevol locations
166
+
167
+ # Pagination
168
+ xevol locations --page 2 --limit 50
169
+
170
+ # Filter by time window
171
+ xevol locations --since 2026-01-01T00:00:00Z --until 2026-01-31T23:59:59Z
172
+
173
+ # Include exact latitude/longitude
174
+ xevol locations --exact
175
+
176
+ # Machine-readable formats
177
+ xevol locations --json
178
+ xevol locations --csv
179
+ ```
180
+
181
+ | Flag | Description |
182
+ | --------------- | ------------------------------------------- |
183
+ | `--page <n>` | Page number |
184
+ | `--limit <n>` | Results per page |
185
+ | `--since <iso>` | Include records at/after this ISO datetime |
186
+ | `--until <iso>` | Include records at/before this ISO datetime |
187
+ | `--exact` | Include exact latitude/longitude columns |
188
+ | `--json` | JSON output |
189
+ | `--csv` | CSV output |
151
190
 
152
191
  ### `xevol view`
153
192
 
@@ -167,11 +206,11 @@ xevol view abc123def45 --clean
167
206
  xevol view abc123def45 --json
168
207
  ```
169
208
 
170
- | Flag | Description |
171
- |------|-------------|
172
- | `--raw` | Print the full transcript text |
173
- | `--clean` | Use cleaned/processed content |
174
- | `--json` | JSON output |
209
+ | Flag | Description |
210
+ | --------- | ------------------------------ |
211
+ | `--raw` | Print the full transcript text |
212
+ | `--clean` | Use cleaned/processed content |
213
+ | `--json` | JSON output |
175
214
 
176
215
  ### `xevol analyze`
177
216
 
@@ -188,11 +227,11 @@ xevol analyze abc123def45 --prompt facts --lang de
188
227
  xevol analyze abc123def45 --prompt facts --json
189
228
  ```
190
229
 
191
- | Flag | Description |
192
- |------|-------------|
230
+ | Flag | Description |
231
+ | --------------- | --------------------------------- |
193
232
  | `--prompt <id>` | Prompt to use (default: `review`) |
194
- | `--lang <code>` | Output language |
195
- | `--json` | JSON output |
233
+ | `--lang <code>` | Output language |
234
+ | `--json` | JSON output |
196
235
 
197
236
  Use `xevol prompts` to see all available prompts.
198
237
 
@@ -241,12 +280,12 @@ xevol config set default.limit 50
241
280
 
242
281
  Available config keys:
243
282
 
244
- | Key | Description |
245
- |-----|-------------|
246
- | `apiUrl` | Base API URL |
247
- | `default.lang` | Default output language |
283
+ | Key | Description |
284
+ | --------------- | ---------------------------- |
285
+ | `apiUrl` | Base API URL |
286
+ | `default.lang` | Default output language |
248
287
  | `default.limit` | Default page size for `list` |
249
- | `api.timeout` | API request timeout (ms) |
288
+ | `api.timeout` | API request timeout (ms) |
250
289
 
251
290
  ## Output Formats
252
291
 
@@ -327,13 +366,13 @@ xevol list --csv > my-transcriptions.csv
327
366
 
328
367
  ## Global Options
329
368
 
330
- | Flag | Description |
331
- |------|-------------|
369
+ | Flag | Description |
370
+ | ----------------- | ---------------------------------------- |
332
371
  | `--token <token>` | Override auth token for a single command |
333
- | `--no-color` | Disable colored output |
334
- | `--json` | Machine-readable JSON output |
335
- | `-V, --version` | Print version |
336
- | `-h, --help` | Show help |
372
+ | `--no-color` | Disable colored output |
373
+ | `--json` | Machine-readable JSON output |
374
+ | `-V, --version` | Print version |
375
+ | `-h, --help` | Show help |
337
376
 
338
377
  ## Links
339
378
 
package/dist/bin.js ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ globalThis.self = globalThis;
3
+ await import("./index.js");