Query aVenture's research data on companies, people, funding, and news from your
terminal. The package installs one command, aventure.
For a guided walkthrough, read the aVenture CLI quickstart.
The CLI requires Node.js 24.18 or later in the 24.x series. Installation fails on any other major version.
npm install --global @aventurevc/aventure-cli --@aventurevc:registry=https://registry.npmjs.org/
aventure --versionThe --@aventurevc:registry flag makes npm install from the public npm registry
even when your npm configuration maps the @aventurevc scope somewhere else.
Public reads need no account. This command finds a company by its website domain:
aventure entities lookup get --url-domain stripe.comName lookups and searches need a signed-in account. Choose one credential.
aventure auth login
aventure lookup Stripeaventure auth login prints a one-time code and a sign-in URL, opens your browser
when one is available, and waits until you approve. You can approve on any device,
so the same command works on a laptop, over SSH, and in a container. Add
--no-browser to print the URL without opening a browser. The approval page uses
the aVenture account already signed in to that browser; to use another account,
open the URL in a private window.
The CLI saves the credential in your operating system's credential store. When no
credential store is available, such as on a server without a desktop session, it
saves the credential to ~/.config/aventure/credentials.json with file mode
0600. Expired access is renewed automatically.
Review or revoke CLI sign-ins in aVenture developer access settings.
Create a key in
aVenture API key settings, then provide it
in the AUTH_TOKEN environment variable from your shell or secret manager. Use
this path for CI and other non-interactive environments.
To create and save a key through browser approval instead, run
aventure auth login --key.
aventure auth statusshows which credential is in use and where it is stored, without printing the secret.aventure auth doctorchecks the CLI version, API connection, credential, and command catalog in one call, and names the command that fixes each failure.aventure auth logoutrevokes the saved API key and removes the saved sign-in.
Calls made with your credential count toward your aVenture plan's usage. Some
operations, such as plain-English search, need a plan that includes them; without
one, the API responds with status 402.
- Compare plans on the aVenture pricing page.
- Check your plan and current usage in aVenture subscription settings.
aventure --help
aventure entities --help
aventure help entities lookup get
aventure command-catalog search company lookup --format compactaventure <command> --help lists a command's options, and aventure help <command>
prints its full documentation. aventure command-catalog search finds the command
for a task without calling the API. Help and the catalog work without signing in.
Every command accepts one output mode:
--textprints readable lines. It is the default in a terminal.--dataprints the response data as JSON. It is the default when output is piped.--jsonprints the full result envelope, capped at 50 KB.--data-fullprints uncapped JSON.
The CLI exits with 0 when the call succeeded and 1 when it failed.
aventure completion zsh,aventure completion bash, andaventure completion fishprint completion scripts, andaventure completion installinstalls them.aventure updatechecks for a newer release and installs it.
The CLI writes diagnostics to standard error and sends no telemetry.
The command set is generated from the public aVenture OpenAPI specification.
Apache License 2.0. See the LICENSE file.