Tendrill CLI

The official CLI for Tendrill — your AI-powered financial copilot.

Built for humans, AI agents, and CI/CD pipelines.

Install

npm install -g tendrill-cli

Or run without installing:

npx tendrill-cli

Quick Start

# Store your API key
tendrill-cli login --key tdrl_your_api_key_here

# View your portfolio
tendrill-cli holdings

# Portfolio analytics
tendrill-cli analytics

# Last 30 days of transactions
tendrill-cli transactions

# Get a stock quote
tendrill-cli market AAPL

# Compare multiple tickers
tendrill-cli market AAPL NVDA TSLA

Authentication

Create an API key at tendrill.ai/dashboard/settings, then store it:

tendrill-cli login --key tdrl_your_api_key_here

Or run tendrill-cli login interactively and paste the key when prompted.

The CLI resolves your API key using this priority chain:

| Priority | Source | How to set | |-------------|---------------------|---------------------------------------------| | 1 (highest) | --api-key flag | tendrill-cli --api-key tdrl_xxx holdings | | 2 | TENDRILL_API_KEY | export TENDRILL_API_KEY=tdrl_xxx | | 3 (lowest) | Config file | tendrill-cli login |

Commands

login

Store your Tendrill API key.

tendrill-cli login                       # Interactive prompt
tendrill-cli login --key tdrl_xxx        # Direct

| Flag | Description | |--------------|--------------------------------------| | --key | API key to store (skip prompt) |

logout

Remove stored credentials from ~/.config/tendrill/credentials.json.

holdings

View investment holdings grouped by brokerage account.

tendrill-cli holdings
tendrill-cli holdings --json             # Machine-readable output

analytics

Portfolio analytics: total value, sector breakdown, asset allocation, concentration metrics, and health score.

tendrill-cli analytics
tendrill-cli analytics --json

transactions

View bank/credit card or investment transactions. Defaults to the last 30 days.

# Credit card / bank transactions
tendrill-cli transactions
tendrill-cli transactions --institution Chase
tendrill-cli transactions --card 4829
tendrill-cli transactions --category FOOD_AND_DRINK
tendrill-cli transactions --merchant Starbucks
tendrill-cli transactions --start-date 2025-01-01 --end-date 2025-01-31

# Investment transactions
tendrill-cli transactions --investment
tendrill-cli transactions --investment --type sell
tendrill-cli transactions --investment --subtype "dividend reinvestment"

# Pagination
tendrill-cli transactions --limit 50 --offset 100

| Flag | Description | |---------------------------|--------------------------------------------------------------------| | --investment | Show investment transactions (buys, sells, dividends) | | --start-date <YYYY-MM-DD> | Start date (default: 30 days ago) | | --end-date <YYYY-MM-DD> | End date (default: today) | | --institution <name> | Filter by institution (e.g. Chase, Amex). Partial match. | | --card <name> | Filter by card name or last 4 digits (e.g. 4829, Sapphire) | | --category <name> | Filter by category (e.g. FOOD_AND_DRINK, TRANSPORTATION) | | --merchant <name> | Filter by merchant name. Partial match. | | --type <type> | Investment only: buy, sell, dividend, transfer | | --subtype <subtype> | Investment only: e.g. dividend reinvestment, contribution | | --limit <n> | Max transactions to return | | --offset <n> | Skip first N transactions (pagination) |

watchlist

Manage your watchlist.

tendrill-cli watchlist                   # View watchlist
tendrill-cli watchlist list              # Same as above
tendrill-cli watchlist add AAPL NVDA TSLA
tendrill-cli watchlist remove TSLA

market

Get real-time market data. Supports one or more tickers.

# Single ticker snapshot
tendrill-cli market AAPL

# Multiple tickers side-by-side
tendrill-cli market AAPL NVDA TSLA

# Key stats (52-week range, SMAs, daily change)
tendrill-cli market AAPL --stats
tendrill-cli market AAPL NVDA --stats

# Top gainers and losers
tendrill-cli market --movers
tendrill-cli market --movers --limit 20

| Flag | Description | |-----------------|----------------------------------------------------------| | --stats | Show key stats (52-week range, SMAs) instead of snapshot | | --movers | Show top market movers (gainers and losers) | | --limit <n> | Number of movers per category (default: 10) |

categories

List transaction categories from the Plaid taxonomy. Useful for agents to compose --category flags programmatically.

tendrill-cli categories                  # Primary categories
tendrill-cli categories --detailed       # All subcategories with descriptions
tendrill-cli categories --json           # Machine-readable list of primary categories
tendrill-cli categories --detailed --json # Full taxonomy as JSON array

| Flag | Description | |-----------------|----------------------------------------------------------| | --detailed | Show detailed subcategories with descriptions |

doctor

Run environment diagnostics — checks CLI version, API key, config path, and MCP connectivity.

tendrill-cli doctor

Global Options

| Flag | Description | |------------------|----------------------------------------------| | --api-key <key>| Override API key for this invocation | | --json | Force JSON output | | --version | Print version and exit | | --help | Show help text |

Output Behavior

| Mode | When | Output | |-------------|--------------------|-----------------| | Interactive | Terminal (TTY) | Formatted text | | Machine | Piped or --json | JSON |

Pipe to jq for machine processing:

tendrill-cli holdings --json | jq '.accounts[].holdings'
tendrill-cli transactions --json | jq '.cards[].transactions[] | select(.amount > 50)'
tendrill-cli market AAPL --json | jq '.tickers[0].day'

Configuration

| Item | Path | |---------------|-----------------------------------------| | Credentials | ~/.config/tendrill/credentials.json |

CI/CD Usage

Set TENDRILL_API_KEY as an environment variable — no tendrill-cli login needed:

# GitHub Actions
env:
  TENDRILL_API_KEY: ${{ secrets.TENDRILL_API_KEY }}
steps:
  - run: npx tendrill-cli holdings --json

Development

# From the repo root
cd cli
pnpm install
bun run dev -- --help       # Run in development
bun run build               # Build to dist/cli.js

License

MIT