​
FindU CLI Reference

The findu CLI is your command center for all development tasks. It wraps complex operations into simple, memorable commands.

​
Installation

The CLI is automatically set up when you run the initial setup: 
# After setup, the CLI is available at:
./findu
Add an alias to your shell profile for easier access:
echo "alias findu='~/findu/findu'" >> ~/.zshrc

​
Core Commands

​
Setup & Environment

# Initial setup for new developers
./findu setup

​
Development

# Clone all FindU repositories
./findu clone

​
Documentation

# Start local documentation server
./findu docs preview

# Create new documentation
./findu docs new [path]
./findu docs new [path] api
./findu docs new [path] guide

# Validate documentation
./findu docs validate

​
Database Operations

# Run migrations
./findu db migrate

# Create new migration
./findu db new [name]

# Reset database (dev only)
./findu db reset

​
Command Details

​
findu setup

Runs the complete developer setup:
  • Clones all repositories
  • Installs dependencies
  • Creates .env.local
  • Configures MCP
  • Sets up pre-commit hooks
Options:
  • --skip-clone - Skip repository cloning
  • --skip-deps - Skip dependency installation

​
findu env

Manages environment configuration. Subcommands:
  • switch [dev|prod] - Switch active environment
  • status - Show current environment
  • validate - Check configuration validity

​
findu update

Updates various components. Subcommands:
  • deps - Update all repository dependencies
  • mcp - Update MCP configuration for Claude Code
  • tools - Update dev-tools to latest version

​
findu docs

Manages Mintlify documentation. Subcommands:
  • preview - Start local preview server (port 3000)
  • new [path] [template] - Create new doc page
  • validate - Check for broken links and errors
  • install - Install Mintlify CLI
Templates:
  • api - API endpoint documentation
  • guide - Step-by-step guide
  • (default) - Basic documentation page

​
findu test

Runs tests for specific components. Components:
  • ios - iOS app tests
  • web - Web app tests
  • ml - ML algorithm tests
  • all - All component tests
Options:
  • --watch - Run in watch mode
  • --coverage - Generate coverage report

​
findu db

Database operations (Supabase). Subcommands:
  • migrate - Apply pending migrations
  • new [name] - Create new migration
  • reset - Reset database (dev only!)
  • status - Show migration status

​
Advanced Usage

​
Chaining Commands

Commands can be chained for workflows: 
# Morning setup routine
./findu env switch dev && ./findu update deps && ./findu db migrate

​
Environment Variables

The CLI respects these environment variables: 
# Override default findu directory
FINDU_ROOT=/custom/path ./findu setup

# Skip confirmations
FINDU_YES=1 ./findu db reset

# Verbose output
FINDU_VERBOSE=1 ./findu update deps

​
Custom Scripts

Add custom commands by creating scripts in dev-tools/scripts/custom/: 
# Create dev-tools/scripts/custom/my-command.sh
# Then run:
./findu custom my-command

​
Common Workflows

​
Starting Your Day

# 1. Switch to development
./findu env switch dev

# 2. Update dependencies
./findu update deps

# 3. Check migration status
./findu db status

​
Before Opening a PR

# 1. Run tests
./findu test all

# 2. Run linters
./findu lint

# 3. Update documentation
./findu docs validate

​
Debugging Issues

# Check environment
./findu env status

# Validate configuration
./findu env validate

# Update MCP if Claude Code issues
./findu update mcp

​
Troubleshooting

​
Quick Reference Card

CommandDescription
./findu setupInitial developer setup
./findu env switch devSwitch to development
./findu env statusCheck current environment
./findu update depsUpdate all dependencies
./findu update mcpUpdate Claude Code config
./findu docs previewStart docs server
./findu test allRun all tests
./findu db migrateApply migrations
Ready to dive into development? Check out the workflow guide for common patterns and best practices.