GitHub – AshKash/faaadmv: CA DMV automation

Renew your vehicle registration from the terminal.

faaadmv is a REPL-first CLI tool that automates DMV vehicle registration renewal via Playwright. The primary workflow is interactive and designed for manual verification.

• REPL-First Workflow – One command opens an interactive menu
• Status Check – View registration status without logging in
• Renewal with Dry-Run – Validate eligibility and fees without payment
• Watch Mode – Headed browser with slow motion and pause for inspection
• Local Artifacts – Screenshots and debug logs saved locally
• Secure Storage – Config and payment data stored on your machine

uv pip install faaadmv

# Install browser (first time only)
playwright install chromium

In the REPL:

• a Add a vehicle
• s Check registration status
• d Renew (dry-run)
• r Renew registration
• x Remove a vehicle
• m Set default vehicle (when multiple)
• w Toggle watch mode
• q Quit

• Debug log: ~/Library/Application Support/faaadmv/debug.log
• Screenshots: ~/Library/Application Support/faaadmv/artifacts/

These may include plate/VIN information. Delete them if you do not want local traces.

• Python 3.11+
• macOS, Linux, or Windows
• Valid smog certification (CA)
• Current insurance on file with DMV

# Clone the repo
git clone https://github.com/yourusername/faaadmv
cd faaadmv

# Install in dev mode
uv pip install -e ".[dev]"

# Manual testing
faaadmv

See docs/TESTING.md for the manual testing checklist.

• docs/ARCHITECTURE.md
• docs/DATA_MODELS.md
• docs/SECURITY.md
• docs/PROVIDERS.md
• docs/TESTING.md
• docs/PROJECT_STRUCTURE.md

This tool automates publicly available DMV web portals. You are responsible for ensuring all information is accurate and for any transactions initiated. The developers are not liable for failed transactions or fees incurred.