CLI Setup - Nestornotes Docs

The Nestornotes CLI is a first-party command-line client for the public API. It stores API keys in your operating system keychain and stores non-secret profile metadata in a local config file.

Install the CLI after package publishing:

npm install -g @nestornotes/cli

Update an existing global install after package publishing:

npm update -g @nestornotes/cli

During local repository development, run it through pnpm:

pnpm dev:cli --help

Authenticate with an API key from your Nestornotes settings:

nestornotes auth login --api-key nn_live_...

Common commands:

nestornotes auth whoami
nestornotes collections list
nestornotes knowledge list --collection-id <collection_id>
nestornotes search keyword "agent memory"
nestornotes search semantic "recent saved research"
nestornotes credits
nestornotes usage

Useful environment variables:

NESTORNOTES_API_KEY=nn_live_...
NESTORNOTES_API_URL=https://nestornotes.com/api/v1
NESTORNOTES_CONFIG=/path/to/config.json

For local API development, use:

nestornotes auth login \
  --api-url http://localhost:3007/api/v1 \
  --api-key nn_live_...