@thunkedai/cli

Capture anything to your Thunked second brain from the terminal.

Install

npm install -g @thunkedai/cli

The published package is @thunkedai/cli; the executable command is thunked.

For local development from this repo:

cd cli
npm install
npm run build
npm link

For agent/MCP integrations, the currently published MCP package remains:

npx thunked-mcp

Setup

Interactive local setup:

thunked login

Grab your user-owned API key from the developer settings in the Thunked app and paste it when prompted.

Script/CI/agent setup:

export THUNKED_API_KEY="thunked_..."

THUNKED_API_KEY is always preferred over the local config file and is never written to disk by the CLI. In v1, API keys are user-owned; team captures are authorized through the key owner's team membership.

Usage

# Capture a URL
thunked capture https://example.com/interesting-article

# Capture a quick note
thunked capture --text "Remember: the answer is 42"

# Capture into a team inbox or shared collection you can write to
thunked capture https://example.com --team acme
thunked capture --text "Team note" --team acme/research

# Search your brain
thunked search "machine learning"

# See recent items
thunked recent

# Check account status
thunked status

# Check local config, auth presence, and API reachability
thunked doctor

JSON output

Read commands support --json for scripting:

thunked search "rust" --json | jq '.data[0].url'

Custom API endpoint

thunked config baseUrl http://localhost:3000

Auth source inspection

thunked config

This prints whether auth is coming from THUNKED_API_KEY or the local config file without revealing the key.

Diagnostics

thunked doctor
thunked doctor --json
thunked doctor --no-probe

doctor checks the CLI version, Node.js version, API base URL, auth source, and API reachability. It reports whether an API key is present and valid without printing the key or account details.

Development

git clone https://github.com/shugart/jons-brain
cd jons-brain/cli
npm install
npm test
npm run build
node dist/index.js --help
npm pack --dry-run