xmemcli 0.0.2__tar.gz → 0.0.3__tar.gz
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.
- {xmemcli-0.0.2 → xmemcli-0.0.3}/PKG-INFO +4 -28
- {xmemcli-0.0.2 → xmemcli-0.0.3}/README.md +3 -27
- {xmemcli-0.0.2 → xmemcli-0.0.3}/pyproject.toml +1 -1
- {xmemcli-0.0.2 → xmemcli-0.0.3}/uv.lock +1 -1
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/__init__.py +1 -1
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_help.py +2 -1
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_version.py +1 -1
- {xmemcli-0.0.2 → xmemcli-0.0.3}/.gitignore +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_envelope.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_instance_schema.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_login.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_org_cluster.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_output.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_pretty.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_rc.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/_xmem_bridge.py +0 -0
- {xmemcli-0.0.2 → xmemcli-0.0.3}/xmemcli/cli.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: xmemcli
|
|
3
|
-
Version: 0.0.
|
|
3
|
+
Version: 0.0.3
|
|
4
4
|
Summary: Command-line client for the xmemory HTTP API: PKCE auth, instances, read/write, schema and XMD tools.
|
|
5
5
|
Keywords: api,cli,llm,memory,xmemory
|
|
6
6
|
Requires-Python: <4,>=3.12
|
|
@@ -83,7 +83,7 @@ xmemcli version
|
|
|
83
83
|
xmemcli auth login
|
|
84
84
|
```
|
|
85
85
|
|
|
86
|
-
Version: **0.0.
|
|
86
|
+
Version: **0.0.3**.
|
|
87
87
|
|
|
88
88
|
|
|
89
89
|
---
|
|
@@ -153,7 +153,7 @@ Fixed port **9636** ("xmem" on phone keypad) allows SSH/devcontainer forwarding;
|
|
|
153
153
|
|
|
154
154
|
# `xmemcli` — capabilities reference
|
|
155
155
|
|
|
156
|
-
**Version:** `0.0.
|
|
156
|
+
**Version:** `0.0.3` (see `xmemcli version`)
|
|
157
157
|
|
|
158
158
|
`xmemcli` is the command-line client for the **xmemory HTTP API**. It is **human-governed for key acquisition**; an AI-assisted IDE may run reads, writes, and inventory once credentials exist. Humans acquire API keys and change quota limits in the **Console UI**.
|
|
159
159
|
|
|
@@ -187,7 +187,6 @@ Permission-filtered view of what this API key can see.
|
|
|
187
187
|
|---------|-------------|
|
|
188
188
|
| **`org list clusters`** | Clusters visible to this credential |
|
|
189
189
|
| **`org list instances`** | Instances visible to this credential |
|
|
190
|
-
| **`instance list`** | Alias for **`org list instances`** |
|
|
191
190
|
| **`org list keys`** | API keys visible to this credential (metadata only; plaintext never returned) |
|
|
192
191
|
|
|
193
192
|
---
|
|
@@ -199,8 +198,6 @@ Permission-filtered view of what this API key can see.
|
|
|
199
198
|
| **`instance get`** `<instance_id>` | Fetch one instance |
|
|
200
199
|
| **`instance create`** | Create from XMD/JSON schema. Required `--name`; schema via `--schema-file` or `--schema-stdin`. |
|
|
201
200
|
|
|
202
|
-
**Operator-only (intentionally omitted from help and this table):** `instance delete` exists for humans at an interactive TTY (type `yes` to confirm) but is **not advertised** in primary CLI docs yet. Automation should use `DELETE /instances/{id}` over HTTP.
|
|
203
|
-
|
|
204
201
|
---
|
|
205
202
|
|
|
206
203
|
### Schema & XMD
|
|
@@ -315,7 +312,6 @@ xmemcli help write-status
|
|
|
315
312
|
xmemcli help read
|
|
316
313
|
xmemcli help org
|
|
317
314
|
xmemcli help org list instances
|
|
318
|
-
xmemcli help instance list
|
|
319
315
|
xmemcli help instance create
|
|
320
316
|
xmemcli help schema
|
|
321
317
|
xmemcli help schema get
|
|
@@ -340,26 +336,6 @@ Nested topics work at any level that exists in the parser (`help org`, `help org
|
|
|
340
336
|
|
|
341
337
|
---
|
|
342
338
|
|
|
343
|
-
## Command aliases
|
|
344
|
-
|
|
345
|
-
Canonical names appear in `xmemcli` and in help. **Aliases are accepted on the command line but never listed in the overview** — use them in scripts if you already have them; prefer canonical names in new work.
|
|
346
|
-
|
|
347
|
-
| Canonical command | Accepted aliases |
|
|
348
|
-
|-------------------|------------------|
|
|
349
|
-
| **`write-status`** | `write_status`, `writestatus`, `async_write_status`, `asyncwritestatus`, `async-write-status` |
|
|
350
|
-
| **`quota`** | `quota get` |
|
|
351
|
-
|
|
352
|
-
**Help topic aliases** (same targets, for `xmemcli help …` only):
|
|
353
|
-
|
|
354
|
-
| `help` topic you type | Resolves to |
|
|
355
|
-
|-----------------------|-------------|
|
|
356
|
-
| `login` | `auth login` |
|
|
357
|
-
| `logout` | `auth logout` |
|
|
358
|
-
| `write-status`, `write_status`, `writestatus`, `async_write_status`, `asyncwritestatus`, `async-write-status` | `write-status` |
|
|
359
|
-
| `quota get`, `quota-get` | `quota` |
|
|
360
|
-
|
|
361
|
-
---
|
|
362
|
-
|
|
363
339
|
## What `xmemcli` does **not** do
|
|
364
340
|
|
|
365
341
|
| Area | Use the Console instead |
|
|
@@ -372,7 +348,7 @@ Canonical names appear in `xmemcli` and in help. **Aliases are accepted on the c
|
|
|
372
348
|
| **Cluster create/delete** | CLI lists clusters; provisioning in Console |
|
|
373
349
|
| **`read --extraction deep`** | Server has no read-depth knob today |
|
|
374
350
|
| **Raw REST proxy** | Curated response fields only |
|
|
375
|
-
|
|
|
351
|
+
| **Instance deletion** | **Not available in the CLI** — explicitly disabled and reserved for manual human use in the Console. |
|
|
376
352
|
|
|
377
353
|
On HTTP **402** (quota exhausted), stop and ask a human to extend quota in the Console.
|
|
378
354
|
|
|
@@ -75,7 +75,7 @@ xmemcli version
|
|
|
75
75
|
xmemcli auth login
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
Version: **0.0.
|
|
78
|
+
Version: **0.0.3**.
|
|
79
79
|
|
|
80
80
|
|
|
81
81
|
---
|
|
@@ -145,7 +145,7 @@ Fixed port **9636** ("xmem" on phone keypad) allows SSH/devcontainer forwarding;
|
|
|
145
145
|
|
|
146
146
|
# `xmemcli` — capabilities reference
|
|
147
147
|
|
|
148
|
-
**Version:** `0.0.
|
|
148
|
+
**Version:** `0.0.3` (see `xmemcli version`)
|
|
149
149
|
|
|
150
150
|
`xmemcli` is the command-line client for the **xmemory HTTP API**. It is **human-governed for key acquisition**; an AI-assisted IDE may run reads, writes, and inventory once credentials exist. Humans acquire API keys and change quota limits in the **Console UI**.
|
|
151
151
|
|
|
@@ -179,7 +179,6 @@ Permission-filtered view of what this API key can see.
|
|
|
179
179
|
|---------|-------------|
|
|
180
180
|
| **`org list clusters`** | Clusters visible to this credential |
|
|
181
181
|
| **`org list instances`** | Instances visible to this credential |
|
|
182
|
-
| **`instance list`** | Alias for **`org list instances`** |
|
|
183
182
|
| **`org list keys`** | API keys visible to this credential (metadata only; plaintext never returned) |
|
|
184
183
|
|
|
185
184
|
---
|
|
@@ -191,8 +190,6 @@ Permission-filtered view of what this API key can see.
|
|
|
191
190
|
| **`instance get`** `<instance_id>` | Fetch one instance |
|
|
192
191
|
| **`instance create`** | Create from XMD/JSON schema. Required `--name`; schema via `--schema-file` or `--schema-stdin`. |
|
|
193
192
|
|
|
194
|
-
**Operator-only (intentionally omitted from help and this table):** `instance delete` exists for humans at an interactive TTY (type `yes` to confirm) but is **not advertised** in primary CLI docs yet. Automation should use `DELETE /instances/{id}` over HTTP.
|
|
195
|
-
|
|
196
193
|
---
|
|
197
194
|
|
|
198
195
|
### Schema & XMD
|
|
@@ -307,7 +304,6 @@ xmemcli help write-status
|
|
|
307
304
|
xmemcli help read
|
|
308
305
|
xmemcli help org
|
|
309
306
|
xmemcli help org list instances
|
|
310
|
-
xmemcli help instance list
|
|
311
307
|
xmemcli help instance create
|
|
312
308
|
xmemcli help schema
|
|
313
309
|
xmemcli help schema get
|
|
@@ -332,26 +328,6 @@ Nested topics work at any level that exists in the parser (`help org`, `help org
|
|
|
332
328
|
|
|
333
329
|
---
|
|
334
330
|
|
|
335
|
-
## Command aliases
|
|
336
|
-
|
|
337
|
-
Canonical names appear in `xmemcli` and in help. **Aliases are accepted on the command line but never listed in the overview** — use them in scripts if you already have them; prefer canonical names in new work.
|
|
338
|
-
|
|
339
|
-
| Canonical command | Accepted aliases |
|
|
340
|
-
|-------------------|------------------|
|
|
341
|
-
| **`write-status`** | `write_status`, `writestatus`, `async_write_status`, `asyncwritestatus`, `async-write-status` |
|
|
342
|
-
| **`quota`** | `quota get` |
|
|
343
|
-
|
|
344
|
-
**Help topic aliases** (same targets, for `xmemcli help …` only):
|
|
345
|
-
|
|
346
|
-
| `help` topic you type | Resolves to |
|
|
347
|
-
|-----------------------|-------------|
|
|
348
|
-
| `login` | `auth login` |
|
|
349
|
-
| `logout` | `auth logout` |
|
|
350
|
-
| `write-status`, `write_status`, `writestatus`, `async_write_status`, `asyncwritestatus`, `async-write-status` | `write-status` |
|
|
351
|
-
| `quota get`, `quota-get` | `quota` |
|
|
352
|
-
|
|
353
|
-
---
|
|
354
|
-
|
|
355
331
|
## What `xmemcli` does **not** do
|
|
356
332
|
|
|
357
333
|
| Area | Use the Console instead |
|
|
@@ -364,7 +340,7 @@ Canonical names appear in `xmemcli` and in help. **Aliases are accepted on the c
|
|
|
364
340
|
| **Cluster create/delete** | CLI lists clusters; provisioning in Console |
|
|
365
341
|
| **`read --extraction deep`** | Server has no read-depth knob today |
|
|
366
342
|
| **Raw REST proxy** | Curated response fields only |
|
|
367
|
-
|
|
|
343
|
+
| **Instance deletion** | **Not available in the CLI** — explicitly disabled and reserved for manual human use in the Console. |
|
|
368
344
|
|
|
369
345
|
On HTTP **402** (quota exhausted), stop and ask a human to extend quota in the Console.
|
|
370
346
|
|
|
@@ -37,6 +37,8 @@ _HIDDEN_COMMAND_NAMES = frozenset(
|
|
|
37
37
|
"write_status",
|
|
38
38
|
"writestatus",
|
|
39
39
|
"async_write_status",
|
|
40
|
+
"asyncwritestatus",
|
|
41
|
+
"async-write-status",
|
|
40
42
|
}
|
|
41
43
|
)
|
|
42
44
|
_RESET = "\x1b[0m"
|
|
@@ -96,7 +98,6 @@ _OVERVIEW_SECTIONS: tuple[tuple[str, tuple[tuple[str, str], ...]], ...] = (
|
|
|
96
98
|
(
|
|
97
99
|
"Instances",
|
|
98
100
|
(
|
|
99
|
-
("instance list", "List instances visible to this credential (alias for org list instances)"),
|
|
100
101
|
("instance get", "Get a single instance by id"),
|
|
101
102
|
("instance create", "Create a new instance from an XMD/JSON schema"),
|
|
102
103
|
),
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|