Skip to content

Conversation

@avidan
Copy link
Contributor

@avidan avidan commented Jan 26, 2026

Summary

This PR adds multiple ways for candidates to apply to Root Ventures using Claude:

New Application Methods

  • Interactive Terminal - Enhanced web terminal with conversational application flow
  • Claude Desktop - MCP server for applying directly from Claude Desktop
  • Claude CLI - Bash-based skill for Claude CLI users

Key Features

1. Interactive Terminal Application Flow

  • Conversational input collection (name, email, LinkedIn, GitHub, notes)
  • Async form flow with real-time feedback
  • Ctrl+C cancellation support
  • Submits to Attio via Netlify serverless function

2. MCP Server (mcp-server/)

  • Full Model Context Protocol implementation
  • Three tools: list_jobs, get_job_details, apply_to_root_ventures
  • Ready for NPM distribution as @rootvc/jobs-mcp-server
  • Installation guide for Claude Desktop users

3. Claude CLI Skill

  • Simpler bash-based alternative to MCP
  • Natural language application flow
  • Documented in CLAUDE-SKILL-GUIDE.md
  • Can be distributed to candidates

4. Netlify Serverless Function

  • /.netlify/functions/submit-application endpoint
  • Securely handles Attio API integration
  • Environment variable configuration
  • Validation and error handling

5. Job Listing System

  • Added Venture Capital Associate position
  • Enhanced jobs command to list all positions
  • fg [job_id] to view details
  • apply [job_id] for interactive application

Technical Changes

Frontend:

  • config/commands.js - Interactive application flow, enhanced jobs command
  • config/jobs.js - Job listing data
  • js/terminal-ext.js - Added collectInput() for async prompts
  • js/terminal.js - Optimized character input rendering

Backend:

  • netlify/functions/submit-application.js - Attio integration
  • netlify.toml - Netlify configuration

MCP Server:

  • mcp-server/index.js - Full MCP server implementation
  • mcp-server/package.json - NPM package config
  • mcp-server/install.sh - Installation script

Documentation:

  • QUICK-START.md - Getting started guide
  • CLAUDE-SKILL-GUIDE.md - CLI skill documentation
  • DISTRIBUTION-GUIDE.md - How to share with candidates
  • DEPLOYMENT.md - Deployment instructions
  • ENV-SETUP.md - Environment configuration
  • SECURITY.md - Security best practices

How to Test

Test Terminal Application

  1. Deploy to Netlify (or test locally with netlify dev)
  2. Set ATTIO_API_KEY environment variable
  3. Navigate to the terminal
  4. Run apply 1
  5. Follow the interactive prompts

Test MCP Server

  1. cd mcp-server && npm install
  2. Add to Claude Desktop config:
{
  "mcpServers": {
    "root-ventures-jobs": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.js"]
    }
  }
}
  1. Restart Claude Desktop
  2. Say "I want to apply to Root Ventures"

Test Claude CLI Skill

  1. Install skill to ~/.claude/skills/root-ventures-apply/
  2. Run claude in terminal
  3. Say "I want to apply to Root Ventures"

Why This Matters

This makes Root Ventures more accessible to technical candidates and showcases our appreciation for developer tools and technical creativity. Candidates can now apply via:

Deployment Checklist

  • Review and merge PR
  • Add ATTIO_API_KEY to Netlify environment variables
  • Deploy to production
  • Test all application methods
  • (Optional) Publish MCP server to NPM
  • (Optional) Create install script for Claude skill
  • Update job postings to mention Claude application options

🤖 Generated with Claude Code

…ations

This PR adds multiple ways for candidates to apply to Root Ventures using Claude:

## New Features

### 1. Interactive Terminal Application Flow
- Enhanced `apply` command with conversational input collection
- Async form flow that collects name, email, LinkedIn, GitHub, and notes
- Graceful cancellation with Ctrl+C support
- Real-time submission to Attio via Netlify function

### 2. MCP Server for Claude Desktop
- Full Model Context Protocol server implementation
- Three tools: list_jobs, get_job_details, apply_to_root_ventures
- NPM package ready for distribution (@rootvc/jobs-mcp-server)
- Allows applying directly from Claude Desktop conversations

### 3. Claude CLI Skill
- Bash-based skill for Claude CLI users
- Simpler alternative to MCP with fewer dependencies
- Natural language job application flow
- Install script for easy distribution

### 4. Netlify Serverless Function
- `/submit-application` endpoint for secure Attio integration
- Handles application submissions from terminal and MCP
- Environment variable configuration for API keys
- Error handling and validation

### 5. Job Listing System
- Added Venture Capital Associate position to jobs.js
- Enhanced `jobs` command to display all open positions
- `fg [job_id]` to view job details

## Technical Improvements

- Added `collectInput()` method to terminal-ext.js for interactive prompts
- Optimized character input rendering in terminal.js
- Terminal locking mechanism for async operations
- Comprehensive documentation and setup guides

## Documentation

- QUICK-START.md - Getting started guide
- CLAUDE-SKILL-GUIDE.md - Claude CLI skill documentation
- DISTRIBUTION-GUIDE.md - How to share with candidates
- DEPLOYMENT.md - Deployment instructions
- ENV-SETUP.md - Environment configuration
- SECURITY.md - Security best practices
- README files for MCP server

## Why This Matters

Candidates can now apply using:
- Web terminal (existing): https://root.vc → `apply 1`
- Claude Desktop (new): Via MCP server integration
- Claude CLI (new): Via installed skill
- Email (existing): hello@root.vc

This showcases technical creativity and makes Root Ventures more accessible
to the developer community.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy link
Contributor

@ledwards ledwards left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm! :shipit:

@ledwards ledwards merged commit fb4fbbb into main Jan 27, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants