@victor-software-house/exa-cli 0.0.0

package/CHANGELOG.md

@@ -0,0 +1 @@
+# Changelog

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Victor Araújo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @victor-software-house/exa-cli
+
+Public CLI for [Exa](https://exa.ai/) search, contents, and answer.
+
+## Install
+
+Agents and local checkouts install the GitHub Release binary through mise. Pin `0.0.0` — that tag is a rolling channel, not a frozen npm version:
+
+```toml
+[tools]
+"github:victor-software-house/exa-cli" = "0.0.0"
+```
+
+```bash
+mise install
+exa --help
+```
+
+npm is not the install path until the package is published. Do not `npm i -g`. Source checkout:
+
+```bash
+mise install
+bun src/cli.ts --help
+```
+
+The binary name is `exa`. That can collide with the old `exa` / `eza` ls replacement.
+
+## Auth
+
+Set `EXA_API_KEY`, or pass `--api-key`. There is no interactive login.
+
+Operator checkouts with the global fnox profile `exa` get the key from mise (`mise.dev.toml` / `mise -E test`). Contributors can export the variable themselves.
+
+## Commands
+
+```bash
+exa search "Exa search type auto vs neural official docs" --include-domain exa.ai
+exa contents https://exa.ai/docs/reference/search.md
+exa answer "What Exa search type replaces the deprecated research API?"
+exa doctor
+```
+
+Stdout is the payload. Stderr is progress, cache hits, and errors. `--json` keeps the provider body `jq`-friendly. Cache metadata stays on stderr unless `--envelope`.
+
+## Cache
+
+Identical requests are served from a local SQLite cache under `$XDG_CACHE_HOME/exa-cli/` or `~/.cache/exa-cli/`. Default TTL is 24 hours.
+
+- `--refresh` ignores a stored hit and overwrites it
+- `--no-cache` skips read and write
+- `--ttl` overrides the TTL in seconds
+
+Do not repeat an identical call from an agent loop. Use `--refresh` only when you need a fresh provider response.
+
+## Agent skill
+
+```bash
+npx skills add victor-software-house/exa-cli
+```
+
+## Development
+
+```bash
+mise install
+mise run verify
+bun src/cli.ts search --help
+```

package/dist/cli.d.mts

@@ -0,0 +1 @@
+import "zod/compile";