aVenture CLI

Research private companies, founders, investors, funding rounds, and news from your terminal. The package installs one command, aventure.

You need an aVenture account; free and paid plans both work. Create an account.

Get Started in One Step

Paste this into Claude Code, Codex, ChatGPT, or any assistant that can run terminal commands:

Set up the aVenture CLI for me. Install it with
`npm install --global @aventurevc/aventure-cli` (it needs Node.js 24.18.0 or
later), then run `aventure auth login` so I can approve the sign-in in my browser (if no
browser opens, show me the sign-in link and code it prints). When I'm signed in, run `aventure entities lookup-exact get --url https://stripe.com` to confirm it
works. Use `aventure --help` to find other commands.
Docs: https://docs.aventure.vc/cli

CLI, MCP, or Researchly?

| Where you work | Use | | --- | --- | | A terminal, shell scripts, or a coding agent with a shell | This CLI | | Claude, ChatGPT, or another desktop, web, or cloud AI app | The aVenture MCP server | | Researchly | Nothing to install: open Profile, then MCP servers and choose Connect aVenture |

Set Up by Hand

Requires Node.js 24.18.0 or later.

npm install --global @aventurevc/aventure-cli
aventure auth login

aventure auth login opens your browser to sign in and waits while you approve. Without a browser, such as over SSH or in a container, it prints a sign-in URL and a one-time code to approve on any device; --no-browser forces that mode.

For CI and other non-interactive environments, create a key in API key settings and provide it in the AUTH_TOKEN environment variable from your secret manager.

Find a Company

Finding a company or person by name (lookup) or by description (search) needs a paid plan (AI Plus or AI Pro). On the free plan, find a company by its website with aventure entities lookup-exact get --url https://stripe.com or by keyword with aventure entities search --text-search Stripe.

aventure lookup --name Stripe                            # by name
aventure lookup --url https://stripe.com                  # by website
aventure search --query "payments infrastructure for online businesses"  # by description

Add --location or --context to tell companies with the same name apart:

aventure lookup --name Mercury --context "banking for startups" --location "San Francisco"

Find a Person

aventure lookup --kind PERSON --name "Patrick Collison" --context "Stripe co-founder"
aventure lookup --kind PERSON --name "Patrick Collison" --url https://www.linkedin.com/in/patrickcollison
aventure search --query "fintech founders who previously worked at PayPal"

Go Deeper on a Record

A lookup returns the record's id. Use it to read the full profile and what is attached to it:

aventure entities get --entity-id <id>
aventure entities fundraise-rounds list --entity-id <id>
aventure people get --person-id <id>

Plans and Usage

Profile views, web searches, and research requests count toward your plan's monthly allowance. When one runs out, the command stops with a message that says which limit you reached and how to upgrade.

aventure billing subscription get                        # your plan and usage
aventure billing plans list                              # monthly and annual prices
aventure billing plan-changes create --plan <plan>       # upgrade a paid plan with the card on file
aventure billing checkout-sessions create --plan <plan>  # subscribe from the free plan

You can also manage your plan in subscription settings.

More

• aventure --help and aventure <command> --help list commands and options.
• aventure command-catalog search funding rounds --format compact finds a command for a task.
• --text (terminal default), --data (JSON, default when piped), and --json (full envelope) choose the output. Exit code 0 means success, 1 failure.
• aventure auth doctor checks your setup and names the fix for each problem.

Documentation

• CLI quickstart
• Authentication and plans
• Errors

License

Apache License 2.0. See the LICENSE file.