@lucasygu/yc-cli 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,240 @@
+# yc — CLI for YC Startup School, a16z Speedrun & South Park Commons
+
+A CLI tool for managing your YC Startup School journey, submitting a16z Speedrun applications, and applying to South Park Commons — all from the terminal.
+
+> ### Easiest way to get started
+>
+> Paste this to your AI coding agent (Claude Code, Cursor, Codex, Windsurf, OpenClaw, etc.):
+>
+> **"Install the `@lucasygu/yc-cli` tool via npm and run `yc whoami` to verify it works. Repo: https://github.com/lucasygu/yc-cli"**
+>
+> OpenClaw users can also run: **`clawhub install yc`**
+>
+> The agent will handle installation, verify the connection, and troubleshoot any cookie issues. Just make sure you're logged into [startupschool.org](https://www.startupschool.org/) in Chrome first.
+>
+> Once installed, try: **"Check my YC Startup School dashboard and submit this week's update"** — the agent will pull your streak, curriculum progress, and walk you through submitting.
+
+## Install
+
+```bash
+npm install -g @lucasygu/yc-cli
+# Or via ClawHub (OpenClaw ecosystem)
+clawhub install yc
+```
+
+Requires Node.js >= 22.
+
+- **YC Startup School**: Uses cookies from your Chrome browser session — log into [startupschool.org](https://www.startupschool.org/) in Chrome first.
+- **a16z Speedrun**: No authentication needed (public API).
+- **South Park Commons**: Uses Playwright (headless Chromium) to fill Airtable forms — no auth needed.
+
+After installing, run `yc whoami` to verify the connection. If macOS shows a Keychain prompt, click "Always Allow". The CLI auto-detects all Chrome profiles to find your YC session.
+
+## What You Can Do
+
+- **Dashboard tracking** — Check your streak, curriculum progress, and weekly update status
+- **Weekly updates** — Submit updates from the terminal (interactive or scripted)
+- **Update history** — Review all past updates with metrics, morale, and goals
+- **Speedrun applications** — Apply to a16z Speedrun with a JSON template or interactively
+- **Deck upload** — Upload pitch deck PDFs for Speedrun applications
+- **SPC applications** — Apply to South Park Commons Founder Fellowship or Community Membership via Playwright browser automation
+
+When used through an AI agent, these workflows chain together automatically. Each CLI command also works standalone.
+
+## Quick Start
+
+```bash
+# YC Startup School
+yc whoami                    # Test connection, show user info
+yc dashboard                 # Show streak, curriculum, weekly status
+yc updates                   # List all weekly updates
+yc show <id>                 # Show a single update in detail
+yc new                       # Submit new weekly update (interactive)
+yc new --metric 5 --morale 7 --talked-to 3   # Non-interactive
+
+# a16z Speedrun
+yc speedrun template         # Generate JSON template
+yc speedrun apply            # Interactive application
+yc speedrun apply --from-json app.json        # Submit from JSON
+yc speedrun apply --from-json app.json --dry-run  # Validate only
+yc speedrun upload-deck deck.pdf              # Upload pitch deck
+
+# South Park Commons
+yc spc info                  # Show programs and form URLs
+yc spc template              # Generate JSON template (fellowship)
+yc spc template --type membership             # Community membership
+yc spc apply                 # Interactive application
+yc spc apply --from-json app.json             # Fill from JSON
+yc spc apply --from-json app.json --dry-run --headed  # Visual preview
+yc spc open                  # Open form in browser
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whoami` | Test connection and show current user info |
+| `dashboard` | Show streak, curriculum progress, and weekly update status |
+| `updates` | List all weekly updates with metrics and morale |
+| `show <id>` | Show a single update in full detail |
+| `new` | Submit a new weekly update (interactive or with flags) |
+| `speedrun template` | Generate a JSON template for a16z Speedrun application |
+| `speedrun apply` | Submit a Speedrun application (interactive or from JSON) |
+| `speedrun upload-deck <file>` | Upload a pitch deck PDF |
+| `spc info` | Show SPC programs and form URLs |
+| `spc template` | Generate a JSON template for SPC application |
+| `spc apply` | Fill and submit SPC application via Playwright |
+| `spc open` | Open SPC application form in browser |
+
+### Global Options (YC Startup School)
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--cookie-source <browser>` | Browser to read cookies from (chrome, safari, firefox) | `chrome` |
+| `--chrome-profile <name>` | Chrome profile directory name (e.g., "Profile 1"). Auto-detected if omitted. | auto |
+| `--json` | Output as JSON | `false` |
+
+### Weekly Update Options (`yc new`)
+
+| Option | Description |
+|--------|-------------|
+| `--metric <value>` | Primary metric value (number) |
+| `--morale <value>` | Morale 1-10 |
+| `--talked-to <value>` | Users talked to (number) |
+| `--change <text>` | What most improved your metric |
+| `--blocker <text>` | Biggest obstacle |
+| `--learned <text>` | What you learned from users |
+| `--goal <goals...>` | Goals for next week (can specify multiple) |
+
+### Speedrun Options (`yc speedrun apply`)
+
+| Option | Description |
+|--------|-------------|
+| `--from-json <file>` | Load application from a JSON file |
+| `--dry-run` | Validate and show payload without submitting |
+
+### SPC Options (`yc spc apply`)
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--type <type>` | Form type: `fellowship` or `membership` | `fellowship` |
+| `--from-json <file>` | Load application from JSON file | — |
+| `--dry-run` | Fill form but do not submit | `false` |
+| `--headed` | Show browser window (default: headless) | `false` |
+
+### Speedrun Categories
+
+```
+B2B / Enterprise Applications
+Consumer Applications
+Deep Tech
+Gaming / Entertainment Studio
+Infrastructure / Dev Tools
+Healthcare
+GovTech
+Web3
+Other
+```
+
+### SPC Programs
+
+| Program | Funding | Duration |
+|---------|---------|----------|
+| Founder Fellowship | $400K for 7% + $600K follow-on | Cohort-based (Spring/Fall) |
+| Community Membership | No funding | Up to 6 months |
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| `No session cookie found` | Log into startupschool.org in Chrome, then retry |
+| macOS Keychain prompt | Enter your password and click "Always Allow" — the CLI needs to decrypt Chrome's cookies |
+| Multiple Chrome profiles | The CLI auto-scans all profiles. To pick one: `--chrome-profile "Profile 1"` |
+| Using Brave/Arc/other | Try `--cookie-source safari`, or log into startupschool.org in Chrome |
+| Speedrun API error | No auth needed — check your internet connection |
+| SPC form timeout | Airtable forms are heavy SPAs. Retry or use `--headed` to debug |
+
+## How It Works
+
+**YC Startup School** — Reads your session cookies from Chrome (via [@steipete/sweet-cookie](https://github.com/steipete/sweet-cookie)), extracts the Rails CSRF token, then uses GraphQL for reads (`/graphql` endpoint) and Rails REST for writes (weekly update submission). No browser automation needed — just HTTP requests.
+
+**a16z Speedrun** — Direct JSON API calls to Speedrun's public endpoint. No authentication, no signing, no cookies. Upload pitch decks via GCS signed URLs.
+
+**South Park Commons** — SPC uses Airtable Interface forms (client-rendered SPAs). Since there's no public API, the CLI uses [Playwright](https://playwright.dev/) to navigate, fill, and submit the form programmatically. Supports headless and headed modes for preview before submission.
+
+## Workflows
+
+### Weekly Update Routine
+
+```bash
+yc dashboard            # Check streak and status
+yc new                  # Submit this week's update
+yc updates              # Verify it's there
+```
+
+### Speedrun Application via AI Agent
+
+```bash
+yc speedrun template > /tmp/speedrun-app.json         # Generate template
+# ... AI fills in the JSON with your details ...
+yc speedrun apply --from-json /tmp/speedrun-app.json --dry-run  # Validate
+yc speedrun apply --from-json /tmp/speedrun-app.json            # Submit
+```
+
+### SPC Application via AI Agent
+
+```bash
+yc spc template > /tmp/spc-app.json                           # Generate template
+# ... AI fills in the JSON with your details ...
+yc spc apply --from-json /tmp/spc-app.json --dry-run --headed  # Preview in browser
+yc spc apply --from-json /tmp/spc-app.json                     # Submit
+```
+
+## AI Agent Integration
+
+### Claude Code
+
+Installs automatically as a Claude Code skill. Use `/yc` in Claude Code:
+
+```
+/yc whoami                    # Test connection
+/yc dashboard                 # Check streak
+/yc new                       # Submit weekly update
+/yc speedrun apply            # Apply to a16z Speedrun
+/yc spc apply                 # Apply to SPC
+```
+
+You can give natural language instructions for complex tasks:
+
+- *"Check my Startup School dashboard and tell me if I need to submit this week"*
+- *"Submit my weekly update — metric is 15, morale is 8, talked to 5 users"*
+- *"Help me apply to a16z Speedrun with my startup details"*
+- *"Fill out an SPC Founder Fellowship application for me"*
+
+Claude will automatically generate templates, fill in your details, validate, and submit.
+
+### OpenClaw / ClawHub
+
+Officially supports [OpenClaw](https://openclaw.ai) and [ClawHub](https://docs.openclaw.ai/tools/clawhub). Install via ClawHub:
+
+```bash
+clawhub install yc
+```
+
+All `yc` commands are available in OpenClaw after installation. The SKILL.md is compatible with both Claude Code and OpenClaw ecosystems.
+
+## Authentication
+
+| Platform | Method | Setup |
+|----------|--------|-------|
+| YC Startup School | Chrome session cookies | Log into startupschool.org in Chrome |
+| a16z Speedrun | None (public API) | — |
+| South Park Commons | Playwright (headless browser) | — |
+
+## Disclaimer
+
+This tool uses unofficial APIs for YC Startup School. YC may change or block these APIs at any time. The a16z Speedrun API is public. SPC uses Playwright to fill Airtable forms. Use responsibly and at your own risk. This project is not affiliated with Y Combinator, a16z, or South Park Commons.
+
+## License
+
+MIT

package/SKILL.md

@@ -1,8 +1,8 @@
 ---
-description: Manage Y Combinator Startup School from the terminal — weekly updates, dashboard, progress tracking
+description: CLI for YC Startup School, a16z Speedrun, and South Park Commons — weekly updates, dashboard, applications
 allowed-tools: Bash, Read, Write
 name: yc
-version: 0.1.0
+version: 0.2.0
 metadata:
   openclaw:
     requires:
@@ -17,31 +17,53 @@ metadata:
 tags:
   - ycombinator
   - startup-school
+  - a16z
+  - speedrun
+  - south-park-commons
+  - spc
   - productivity
 ---
 
-# YC CLI — Y Combinator Startup School
+# YC CLI — YC Startup School, a16z Speedrun, and South Park Commons
 
-CLI tool for managing your YC Startup School journey. Submit weekly updates, track your streak, and view your dashboard — all from the terminal.
+CLI tool for managing your YC Startup School journey, submitting a16z Speedrun applications, and applying to South Park Commons — all from the terminal.
 
 ## Prerequisites
 
 - Node.js 22+
-- Logged into [startupschool.org](https://www.startupschool.org/) in Chrome
-- macOS (for cookie extraction from Chrome Keychain)
+- For YC commands: Logged into [startupschool.org](https://www.startupschool.org/) in Chrome, macOS
+- For Speedrun commands: No auth required (public API)
+- For SPC commands: Chrome browser (for form auto-fill via Chrome automation)
 
 ## Quick Reference
 
 ```bash
+# YC Startup School
 yc whoami                    # Test connection, show user info
 yc dashboard                 # Show streak, curriculum, weekly status
 yc updates                   # List all weekly updates
 yc show <id>                 # Show a single update in detail
 yc new                       # Submit new weekly update (interactive)
 yc new --metric 5 --morale 7 --talked-to 3   # Non-interactive
+
+# a16z Speedrun
+yc speedrun template         # Generate JSON template
+yc speedrun apply            # Interactive application
+yc speedrun apply --from-json app.json   # Submit from JSON file
+yc speedrun apply --from-json app.json --dry-run  # Validate without submitting
+yc speedrun upload-deck deck.pdf   # Upload pitch deck
+
+# South Park Commons
+yc spc info                  # Show form URLs and program details
+yc spc template              # Generate JSON template (fellowship)
+yc spc template --type membership  # Template for community membership
+yc spc apply                 # Interactive application
+yc spc apply --from-json app.json  # Fill from JSON file
+yc spc apply --from-json app.json --dry-run --headed  # Preview
+yc spc open                  # Open form in browser
 ```
 
-## Commands
+## YC Startup School Commands
 
 ### `yc whoami`
 Test your connection and display user info (name, track, slug).
@@ -81,9 +103,53 @@ yc new \
   --goal "Set up analytics"
 ```
 
+## a16z Speedrun Commands
+
+### `yc speedrun template`
+Generate a JSON template for a Speedrun application. Save it, fill in your details, then submit with `--from-json`.
+
+### `yc speedrun apply`
+Submit a Speedrun application. Two modes:
+
+**Interactive mode** (prompts for all fields):
+```bash
+yc speedrun apply
+```
+
+**From JSON file** (for automation / repeat submissions):
+```bash
+# Generate template, edit it, submit
+yc speedrun template > my-app.json
+# ... edit my-app.json with your details ...
+yc speedrun apply --from-json my-app.json
+
+# Dry run first to validate
+yc speedrun apply --from-json my-app.json --dry-run
+```
+
+### `yc speedrun upload-deck <file>`
+Upload a pitch deck PDF and get the GCS URL to include in your application.
+
+```bash
+yc speedrun upload-deck pitch.pdf
+```
+
+### Speedrun Categories
+```
+B2B / Enterprise Applications
+Consumer Applications
+Deep Tech
+Gaming / Entertainment Studio
+Infrastructure / Dev Tools
+Healthcare
+GovTech
+Web3
+Other
+```
+
 ## Global Options
 
-All commands support:
+YC Startup School commands support:
 - `--cookie-source <browser>` — Browser to read cookies from (chrome, safari, firefox). Default: chrome
 - `--chrome-profile <name>` — Specific Chrome profile directory name
 - `--json` — Output raw JSON (for scripting)
@@ -92,29 +158,89 @@ All commands support:
 
 ### Weekly Update Routine
 ```bash
-# Check if this week's update is submitted
-yc dashboard
+yc dashboard            # Check status
+yc new                  # Submit if needed
+yc updates              # Verify
+```
 
-# If not, submit it
-yc new
+### Speedrun Application via Claude Code
+When the user asks to apply to a16z Speedrun, generate a JSON template, fill it with their info, and submit:
+```bash
+yc speedrun template > /tmp/speedrun-app.json
+# ... Claude fills in the JSON ...
+yc speedrun apply --from-json /tmp/speedrun-app.json --dry-run  # Validate first
+yc speedrun apply --from-json /tmp/speedrun-app.json            # Submit
+```
+
+## South Park Commons Commands
+
+SPC uses Airtable Interface forms. The CLI fills and submits via Playwright (headless Chromium).
 
-# Verify it shows up
-yc updates
+### `yc spc info`
+Show available SPC programs and their Airtable form URLs.
+
+### `yc spc template`
+Generate a JSON template for an SPC application.
+
+```bash
+yc spc template                    # Founder Fellowship (default)
+yc spc template --type membership  # Community Membership
 ```
 
-### Automation with Claude Code
-When the user asks to submit their weekly update, use the `yc new` command with flags:
+### `yc spc apply`
+Fill and submit an SPC application via Playwright (headless browser).
+
 ```bash
-yc new --metric <value> --morale <1-10> --talked-to <count> \
-  --change "summary" --blocker "obstacle" --goal "goal1" --goal "goal2"
+yc spc apply                                          # Interactive
+yc spc apply --from-json my-app.json                  # From JSON file
+yc spc apply --from-json my-app.json --dry-run        # Fill but don't submit
+yc spc apply --from-json my-app.json --headed         # Show browser window
+yc spc apply --from-json my-app.json --dry-run --headed  # Visual review
 ```
 
-## Authentication
+### `yc spc open`
+Open the SPC application form in your default browser.
+
+```bash
+yc spc open                    # Founder Fellowship
+yc spc open --type membership  # Community Membership
+```
+
+### SPC Programs
+
+| Program | Funding | Duration |
+|---------|---------|----------|
+| Founder Fellowship | $400K for 7% + $600K follow-on | Cohort-based (Spring/Fall) |
+| Community Membership | No funding | Up to 6 months |
+
+## Workflows
 
-YC CLI extracts session cookies directly from your browser — no API keys or tokens needed. Just log in to startupschool.org in Chrome and the CLI handles the rest.
+### Weekly Update Routine
+```bash
+yc dashboard            # Check status
+yc new                  # Submit if needed
+yc updates              # Verify
+```
+
+### Speedrun Application via Claude Code
+When the user asks to apply to a16z Speedrun, generate a JSON template, fill it with their info, and submit:
+```bash
+yc speedrun template > /tmp/speedrun-app.json
+# ... Claude fills in the JSON ...
+yc speedrun apply --from-json /tmp/speedrun-app.json --dry-run  # Validate first
+yc speedrun apply --from-json /tmp/speedrun-app.json            # Submit
+```
+
+### SPC Application via Claude Code
+```bash
+yc spc template > /tmp/spc-app.json                        # Generate template
+# ... Claude fills in the JSON ...
+yc spc apply --from-json /tmp/spc-app.json --dry-run --headed  # Preview in browser
+yc spc apply --from-json /tmp/spc-app.json                     # Submit
+```
+
+## Authentication
 
-If you get authentication errors:
-1. Open Chrome and visit https://www.startupschool.org/
-2. Make sure you're logged in (can see dashboard)
-3. Try running `yc whoami` again
-4. If still failing, log out and back in to refresh your session
+- **YC Startup School**: Extracts session cookies from Chrome — log in at startupschool.org first.
+- **a16z Speedrun**: No authentication needed. The API is public.
+- **South Park Commons**: No auth needed. Uses Playwright (headless Chromium) to fill Airtable forms.

package/dist/cli.d.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 /**
- * yc — CLI for Y Combinator Startup School
+ * yc — CLI for Y Combinator Startup School, a16z Speedrun, and SPC
  *
- * Submit weekly updates, track your streak, manage your YC journey
- * from the terminal. Cookie-based auth from your browser session.
+ * Submit weekly updates, track your streak, manage your YC journey,
+ * apply to a16z Speedrun and South Park Commons — all from the terminal.
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map