Teemtape Cli

teemtape CLI

Use the teemtape command-line client to read delayed stock quotes and collaborate on anonymous notes. Notes posted via the CLI appear in the web and mobile apps alongside user notes. This is not a trading tool — quotes are delayed ~1 minute and informational only.

Before you run anything

1. Always pass --json so output is machine-readable.
2. Resolve the CLI binary (first match wins):

• Published (preferred): npx @teemtape/cli
• Or install globally: npm i -g @teemtape/cli then run teemtape
• Monorepo (after npm run build): node packages/cli/dist/index.js
• Root shortcut: npm run cli --

1. Config precedence: CLI flags > env vars > ~/.config/teemtape/config.json > defaults.
2. Never log or echo the watchlist token in chat. Tokens are secrets that identify an anonymous watchlist.

Local development

Against the in-memory mock (no Cloudflare toolchain):

# terminal 1
npm run mock

# terminal 2 — seeded watchlist token
TEEMTAPE_API_URL=http://localhost:8787 \
  teemtape list --token 6f1ed002ab5595859014ebf0951522d9 --json

Against the real Worker locally:

cd workers/api && npm run migrate:local && npm run dev
TEEMTAPE_API_URL=http://127.0.0.1:8787 teemtape init --json

Workflow: first-time setup

teemtape init --json
# → { "token": "...", "url": "https://www.teemtape.com/w/...", "configPath": "..." }

init creates an anonymous watchlist and saves the token to the config file. Subsequent commands pick up the token automatically.

Workflow: find a ticker, add it, check notes

# 1. Search SEC symbol catalog (no token required)
teemtape search nvidia --json

# 2. Add to watchlist
teemtape add NVDA --json

# 3. List delayed quotes
teemtape list --json

# 4. Read existing notes
teemtape notes NVDA --json

# 5. Post a note (tagged source: cli, author: agent-cli)
teemtape note NVDA --message "Your observation here." --json

Commands

* list --symbols fetches quotes without needing symbols on the watchlist, but still needs a token for API auth in most deployments.

Search options

teemtape search --symbol nv --limit 10 --json     # ticker substring
teemtape search --name microsoft --json           # company name substring
teemtape search apple --sort title --offset 20 --json

Parsing --json output

See references/json-output.md for response shapes.

Key types:

• Quote: { symbol, name, price, change, pct, asOf }
• Note: { id, symbol, author, source, body, createdAt } — CLI notes have source: "cli"
• Watchlist: { token, symbols, createdAt }

Agent guidelines

• Read before you write: run notes before posting to avoid duplicating existing commentary.
• Be concise in notes: these are public anonymous comments visible to all watchlist viewers.
• Use search to resolve ambiguous tickers before add or note.
• Handle errors: non-zero exit code with error: … on stderr. Common causes:
  • ECONNREFUSED — API not running; start mock or Worker.
  • HTTP 401/403 — missing or invalid token; run init or pass --token.
  • HTTP 404 — symbol not on watchlist (run add first for watchlist-scoped commands).
• Share links: teemtape share --json returns the anonymous URL others can open in the browser.

Examples by intent

"What's on my watchlist?"

teemtape list --json

"What are people saying about AAPL?"

teemtape notes AAPL --json

"Add my analysis as a note"

teemtape note TSLA --message "Delivery numbers beat estimates; watching margin guidance." --json

"Find the right ticker for Rivian"

teemtape search rivian --json

For the full command reference see references/commands.md.