@victor-software-house/exa-cli 0.0.1 → 0.0.2

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/CHANGELOG.md +8 -0
  2. package/README.md +6 -6
  3. package/package.json +7 -7
  4. package/skills/exa/SKILL.md +9 -9
package/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.0.2
4
+
5
+ ### Patch Changes
6
+
7
+ - Apply the documented dynamic Context token default and accept its observed cost response shape ([`83dd937`](https://github.com/victor-software-house/exa-cli/commit/83dd9375ad85618adfdd5ec8ac04a1da05773113)).
8
+
9
+ - Redesign generated help with concise command menus, focused errors, practical examples, and nested `agent` commands ([`2b9b5bf`](https://github.com/victor-software-house/exa-cli/commit/2b9b5bfa0efe04bd4b8152573b137b604f0f65c1)).
10
+
3
11
  ## 0.0.1
4
12
 
5
13
  ### Patch Changes
package/README.md CHANGED
@@ -47,11 +47,11 @@ exa contents https://exa.ai/docs/reference/search.md
47
47
  exa answer "when did Exa ship the context endpoint"
48
48
  exa similar https://exa.ai/docs/reference/search.md
49
49
  exa context "how to use React hooks for state management" --tokens-num 500
50
- exa agent-create "narrow research question"
51
- exa agent-create "narrow research question" --wait --timeout 600
52
- exa agent-get agent_run_…
53
- exa agent-wait agent_run_… --timeout 600
54
- exa agent-cancel agent_run_…
50
+ exa agent create "narrow research question"
51
+ exa agent create "narrow research question" --wait --timeout 600
52
+ exa agent get agent_run_…
53
+ exa agent wait agent_run_… --timeout 600
54
+ exa agent cancel agent_run_…
55
55
  exa doctor
56
56
  exa cache path|clear|prune
57
57
  ```
@@ -83,7 +83,7 @@ Every uncached call spends Exa credits. Identical requests within the TTL are se
83
83
  - `--refresh` skips the read and overwrites the entry. Use only when staleness provably matters.
84
84
  - `--no-cache` skips reads and writes.
85
85
  - `exa cache prune` deletes expired entries; `exa cache clear` deletes all; `exa cache path` prints the database location.
86
- - `agent-create`, `agent-get`, `agent-wait`, and `agent-cancel` never cache: create and cancel mutate, get and wait poll.
86
+ - `agent create`, `agent get`, `agent wait`, and `agent cancel` never cache: create and cancel mutate, get and wait poll.
87
87
 
88
88
  Do not repeat an identical call in a loop — the first response is already stored.
89
89
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@victor-software-house/exa-cli",
3
- "version": "0.0.1",
3
+ "version": "0.0.2",
4
4
  "description": "Agent-friendly CLI for the Exa API with a local SQLite request cache.",
5
5
  "license": "MIT",
6
6
  "author": {
@@ -34,11 +34,11 @@
34
34
  "optique"
35
35
  ],
36
36
  "optionalDependencies": {
37
- "@victor-software-house/exa-cli-darwin-arm64": "0.0.1",
38
- "@victor-software-house/exa-cli-darwin-x64": "0.0.1",
39
- "@victor-software-house/exa-cli-linux-x64": "0.0.1",
40
- "@victor-software-house/exa-cli-linux-arm64": "0.0.1",
41
- "@victor-software-house/exa-cli-linux-x64-musl": "0.0.1",
42
- "@victor-software-house/exa-cli-windows-x64": "0.0.1"
37
+ "@victor-software-house/exa-cli-darwin-arm64": "0.0.2",
38
+ "@victor-software-house/exa-cli-darwin-x64": "0.0.2",
39
+ "@victor-software-house/exa-cli-linux-x64": "0.0.2",
40
+ "@victor-software-house/exa-cli-linux-arm64": "0.0.2",
41
+ "@victor-software-house/exa-cli-linux-x64-musl": "0.0.2",
42
+ "@victor-software-house/exa-cli-windows-x64": "0.0.2"
43
43
  }
44
44
  }
package/skills/exa/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: exa
3
- description: Use the Exa CLI for live web search, known-page contents, and cited answers. Use when a question needs current web evidence and GitHub source is not already a clone or submodule. Prefer this CLI over ad-hoc HTTP.
3
+ description: Use the Exa CLI for current web evidence, known-page retrieval, cited answers, coding context, or asynchronous Exa Agent research. Prefer it over ad-hoc HTTP; use GitHub tooling or an existing clone or submodule for GitHub implementation truth.
4
4
  ---
5
5
 
6
6
  # Exa CLI
@@ -20,7 +20,7 @@ Every uncached call spends Exa credits. The local SQLite cache makes identical r
20
20
  - Never re-issue an identical request; the response is already cached.
21
21
  - `--refresh` only when a cached answer is provably stale.
22
22
  - `--no-cache` almost never.
23
- - Agent commands (`agent-create`, `agent-get`, `agent-wait`, `agent-cancel`) are never cached and every call is paid.
23
+ - Agent commands (`agent create`, `agent get`, `agent wait`, `agent cancel`) are never cached.
24
24
  - Housekeeping: `exa cache path`, `exa cache prune` (expired entries), `exa cache clear`.
25
25
 
26
26
  The cache key includes a digest of the API key, so switching accounts never serves another account's responses.
@@ -54,14 +54,14 @@ exa similar https://exa.ai/docs/reference/search.md --json
54
54
  exa context "how to use React hooks for state management" --tokens-num 500 --json
55
55
  ```
56
56
 
57
- Agent runs (create is not cached; block with `--wait` or `agent-wait` instead of a manual poll loop):
57
+ Agent runs (create is not cached; block with `--wait` or `agent wait` instead of a manual poll loop):
58
58
 
59
59
  ```bash
60
- exa agent-create "narrow research question" --json
61
- exa agent-create "narrow research question" --wait --timeout 600 --json
62
- exa agent-get agent_run_… --json
63
- exa agent-wait agent_run_… --timeout 600 --json
64
- exa agent-cancel agent_run_… --json
60
+ exa agent create "narrow research question" --json
61
+ exa agent create "narrow research question" --wait --timeout 600 --json
62
+ exa agent get agent_run_… --json
63
+ exa agent wait agent_run_… --timeout 600 --json
64
+ exa agent cancel agent_run_… --json
65
65
  ```
66
66
 
67
67
  Raw body is JSON text for that command's generated Hey API schema. Optique parses it; do not pass a file path:
@@ -72,4 +72,4 @@ exa search --request '{"query":"Exa search type auto","contents":{"highlights":t
72
72
 
73
73
  Do not treat snippets, citations, or generated answers as proof. Read the cited URL before making a factual claim.
74
74
 
75
- `/context` is `exa context`. Agent runs are `exa agent-create`, `exa agent-get`, `exa agent-wait`, and `exa agent-cancel`. GitHub implementation truth still stays `gh` or a pinned submodule.
75
+ `/context` is `exa context`. Agent runs are `exa agent create`, `exa agent get`, `exa agent wait`, and `exa agent cancel`. GitHub implementation truth still stays `gh` or a pinned submodule.