StartupQuestion
Command Line Interface
v0.1.0

Your data, your terminal.

Export concepts, business plans, advisor chats, and pitch decks straight from the command line.

terminal
$ npm install -g agent-startup
added 42 packages in 3s
$ agent-startup login sk_live_abc123...
Authenticated as jane@example.com
$ agent-startup concepts list
┌─────────────────────────────────────────────┐
ID Name Created
├─────────────────────────────────────────────┤
c_8f2a AI Meal Planner 2 days ago
c_3b1d DevOps Dashboard 1 week ago
c_9e4c FinTech Budgeting 2 weeks ago
└─────────────────────────────────────────────┘
3 concepts found

Back Up Your Data

Export all your concepts, plans, and chats to local files for safekeeping.

Integrate with Tools

Pipe JSON or CSV exports into spreadsheets, databases, or automation workflows.

Generate Documents

Create polished PDF or Markdown business plans ready for investors.

Get started in 3 steps

From install to first export in under a minute.

1

Install

Install the CLI globally via npm.

npm install -g agent-startup
2

Authenticate

Generate a token in Settings → API Tokens, then log in.

agent-startup login <your-token>
3

Export

Start exporting your startup data.

agent-startup concepts export -f csv

Commands

Everything you can do from the terminal.

List all concepts
agent-startup concepts list
List favorites only
agent-startup concepts list --favorites
Export to JSON
agent-startup concepts export
Export to CSV
agent-startup concepts export -f csv
Export a single concept
agent-startup concepts export --id <id>
Custom output path
agent-startup concepts export -o my-ideas.json
List all plans
agent-startup plans list
Export as JSON
agent-startup plans export --concept-id <id>
Export as Markdown
agent-startup plans export --concept-id <id> -f markdown
Export as PDF
agent-startup plans export --concept-id <id> -f pdf
List all chats
agent-startup advisors list
Filter by advisor type
agent-startup advisors list --type vc
Export all chats
agent-startup advisors export
Export CTO chats only
agent-startup advisors export --type cto
Export chats for a concept
agent-startup advisors export --concept-id <id>
List all decks
agent-startup pitch list
Export a deck
agent-startup pitch export --concept-id <id>
Log in with token
agent-startup login <your-token>
Check auth status
agent-startup whoami
Remove stored token
agent-startup logout

Authentication

Secure, revocable token-based access separate from your web session.

How It Works

  1. 1Generate a CLI token from the web UI via Settings → API Tokens
  2. 2Token is hashed (SHA-256) and stored securely in the database
  3. 3CLI sends the token as a Bearer header with each request
  4. 4Backend validates the hash and authorizes via user_id foreign key

Security Features

  • Isolated from web sessions

    CLI tokens are independent of browser cookies

  • Instant revocation

    Disable any token from Settings at any time

  • Expiration policies

    Tokens auto-expire based on your settings

  • Audit trail

    Track usage with last_used_at timestamps

  • Self-hosted ready

    Works with custom API base URLs

API Reference

All endpoints available for programmatic access.

Token Management

POST/api/cli/tokenGenerate a new CLI API token
GET/api/cli/tokenList your CLI tokens
DELETE/api/cli/tokenRevoke a CLI token

Data Export

GET/api/cli/conceptsFetch your startup concepts
GET/api/cli/business-plansFetch business plans
POST/api/cli/business-plans/convertConvert plans to PDF/Markdown
GET/api/cli/advisorsFetch advisor chat history
GET/api/cli/pitch-decksFetch pitch decks

Account

GET/api/cli/meGet current user info

All endpoints require authentication via Bearer <token> header.

Self-Hosted Deployments

Running your own instance? Point the CLI to your custom API base URL during login.

agent-startup login <token> --api-base http://localhost:3000

Frequently Asked Questions

Common questions about the CLI tool.

Log in to startupquestion.com, go to Settings → API Tokens, and click "Generate CLI Token". Copy the token and run agent-startup login <token> in your terminal.

The CLI requires internet access to communicate with the StartupQuestion API. However, once you export your data locally (JSON, CSV, PDF), those files are available offline.

You'll receive an authentication error. Simply generate a new token from Settings → API Tokens and run agent-startup login <new-token> again.

Yes. You can generate multiple named tokens — useful for different machines or CI/CD pipelines. Revoke any token individually from Settings.

Yes. Pass your custom API URL during login: agent-startup login <token> --api-base https://your-instance.com

Concepts support JSON and CSV. Business plans support JSON, Markdown, and PDF. Advisor chats and pitch decks export as JSON.

Ready to try the CLI?

Install the package, generate a token, and start exporting your startup data in seconds.