agent-startup
v0.1.2
Published
CLI for startupquestion.com — export your startup concepts, business plans, advisor chats, and pitch decks from the command line.
Maintainers
Readme
agent-startup
Command-line interface for startupquestion.com. Export your startup concepts, business plans, AI advisor conversations, and pitch decks — all from the terminal.
Install
npm install -g agent-startupRequires Node.js 18+.
Quick Start
# 1. Generate a token at startupquestion.com/settings → Developer → Generate CLI Token
# 2. Authenticate
agent-startup login sq_your_token_here
# 3. Verify it worked
agent-startup whoamiCommands
Authentication
agent-startup login <token> # Authenticate (validates against server)
agent-startup login <token> --api-base http://... # Point to self-hosted instance
agent-startup whoami # Show auth status + config location
agent-startup logout # Remove stored credentials
agent-startup status # Full diagnostic: version, auth, configConcepts
agent-startup concepts list # List all concepts
agent-startup concepts list --favorites # Favorites only
agent-startup concepts list --limit 100 # Custom limit (max 200)
agent-startup concepts export # Export all to JSON
agent-startup concepts export -f csv # Export all to CSV
agent-startup concepts export --id <id> # Export single concept
agent-startup concepts export -o my-ideas.json # Custom output pathBusiness Plans
agent-startup plans list # List all plans
agent-startup plans list --limit 100 # Custom limit (max 200)
agent-startup plans export --concept-id <id> # Export as JSON
agent-startup plans export --concept-id <id> -f markdown # Export as Markdown
agent-startup plans export --concept-id <id> -f pdf # Export as PDFAdvisor Chats
agent-startup advisors list # List all chats
agent-startup advisors list --limit 100 # Custom limit (max 200)
agent-startup advisors list --type vc # Filter: vc, cto, coach, intel
agent-startup advisors export # Export all chats with messages
agent-startup advisors export --type cto # Export CTO chats only
agent-startup advisors export --concept-id <id> # Export chats for a conceptPitch Decks
agent-startup pitch list # List all decks
agent-startup pitch list --limit 100 # Custom limit (max 200)
agent-startup pitch export --concept-id <id> # Export deck as JSONGlobal Flags
Every command supports:
| Flag | Description |
|------|-------------|
| --json | Machine-readable JSON output (for CI/CD and scripting) |
| --no-color | Disable ANSI colors (also respects NO_COLOR env var) |
| -v, --version | Show CLI version |
| -h, --help | Show help for any command |
JSON Mode for Scripting
# Pipe concept IDs into another tool
agent-startup concepts list --json | jq '.concepts[].id'
# Check auth status in CI
agent-startup whoami --json | jq '.authenticated'Self-Hosted
Point the CLI at your own instance:
agent-startup login <token> --api-base http://localhost:3000Resilience
- Automatic retries with exponential backoff on transient failures (5xx, timeouts)
- 30s request timeout (60s for downloads) — never hangs
- Human-readable errors for DNS failures, connection refused, rate limits, expired tokens
- Update notifications — checks npm once per day, notifies if a new version is available
Configuration
Credentials are stored locally via conf:
agent-startup status # Shows config file locationLinks
- Web app: startupquestion.com
- Generate tokens: startupquestion.com/settings?tab=developer
- CLI docs: startupquestion.com/cli
- Issues: github.com/sociallabs/startupquestion/issues
License
MIT
