Government paperwork,
without the paperwork.

A delightful terminal tool that turns scary government forms into guided workflows. Fill forms, check eligibility, plan for life events — all from your command line.

36 workflows 13 domains 0 cloud uploads 26 MCP tools 6 intelligence tools

Get Started npm install

pigeongov — life-event

$ pigeongov life-event job-loss Life Event: Job loss Generating prioritized action plan... Action Plan (6 workflows) ─── Phase 1: Immediate (this week) ─── > unemployment/claim-intake (!) [DEADLINE: 7 days] File unemployment claim immediately > healthcare/aca-enrollment (!) [DEADLINE: 60 days] Enroll in ACA marketplace ─── Phase 2: This month ─── > benefits/snap Income drop may qualify your household > benefits/medicaid Check Medicaid eligibility before marketplace ─── Phase 3: When ready ─── > tax/1040 Adjust withholding & estimated payments > retirement/ssa-estimator Recalculate projected benefits with updated work history Done. Run pigeongov fill <workflow-id> to start any workflow.

What can it actually do?

Fill out any government form.

Guided, interactive workflows for tax returns, immigration packets, benefits applications, and more. Answer questions in plain language, get a validated bundle out.

$ pigeongov fill tax/1040

fill — tax/1040

$ pigeongov fill tax/1040 --json Federal Individual Return (2025) Schedule 1, B, C, D & Form 8949 Filing Status: Married Filing Jointly Gross Income: $142,800.00 Adjustments: -$6,500.00 (HSA, IRA) AGI: $136,300.00 Deduction: -$29,200.00 (standard) Taxable: $107,100.00 Tax Calculation Federal: $16,290.00 State (CA): $5,847.00 SE Tax: $2,119.00 Credits: -$4,000.00 (child tax credit x2) Bundle saved to ./1040-bundle.json

Know what you qualify for.

Cross-program eligibility screening for SNAP, Medicaid, Section 8, WIC, LIHEAP, and SSDI. Uses federal poverty level calculations and program-specific rules. No signup required.

$ pigeongov screen benefits/snap

screen — benefits

$ pigeongov screen benefits/snap SNAP Eligibility Screening Household: 4 members | Monthly income: $2,800 Gross Income Test 130% FPL for 4: $3,467/mo Your income: $2,800/mo PASS (81% of threshold) Net Income Test 100% FPL for 4: $2,667/mo After deductions: $2,240/mo PASS (84% of threshold) Asset Test Limit: $2,750 | Yours: $1,200 PASS Result: LIKELY ELIGIBLE Est. monthly benefit: $459 Also check: benefits/medicaid benefits/wic benefits/liheap

Life happens. We help.

Major life changes trigger cascading government paperwork. PigeonGov covers 20 life events — tell it what happened and get a prioritized action plan with deadlines, workflow mappings, and the order to do things in.

$ pigeongov life-event marriage

life-event — marriage

$ pigeongov life-event marriage Life Event: Marriage Action Plan (5 workflows) ─── Phase 1: Right away ─── > identity/name-change Court petition + SSA + DMV + passport cascade > healthcare/aca-enrollment (!) [30 days] Marriage is a qualifying life event ─── Phase 2: Before tax season ─── > tax/1040 Switch to Married Filing Jointly (usually saves $$$) ─── Phase 3: When settled ─── > estate/basic-will Update beneficiaries and estate plan > immigration/family-visa-intake If applicable: spouse petition workflow Tip: Run workflows in order. Phase 1 deadlines are real.

Student loans in crisis? We help.

The SAVE plan is dead. 7.5M borrowers need a new plan before September 2026. PigeonGov compares every option and shows you the math.

$ pigeongov student-loans transition

student-loans — transition

$ pigeongov student-loans transition SAVE Plan Transition Advisor Current: SAVE (in forbearance) Balance: $45,000 ┌─────────────────────────────────────────────────┐ │ ⚠ URGENT: SAVE plan ended March 10, 2026 │ │ ⚠ 8 months in forbearance (not counting!) │ │ ⚠ Switch to IBR or RAP immediately │ └─────────────────────────────────────────────────┘ Plan Comparison: Standard (10-yr) $488/mo $58,564 total IBR (post-2014) $221/mo Forgiven at 20yr RAP $123/mo Forgiven at 30yr ← lowest payment PSLF Progress: 48/120 payments (40%) 72 payments remaining → forgiveness ~2032 Recommendation: Switch to IBR immediately. Your PSLF employment qualifies — forgiveness in 6 years saves $39,000.

The government intelligence layer.

Forms are the beginning. The hard part is knowing which forms matter, what they cost, how they connect, and where the cliffs are.

dependencies

$ pigeongov dependencies immigration/naturalization → identity/voter-registration Naturalized citizens become eligible to vote → identity/passport Can apply for US passport → tax/1040 Changes tax filing requirements ~ benefits/snap Removes 5-year waiting period

benefits cliff

$ pigeongov cliff --income 28000 --household 4 Current Benefits: ● SNAP $345/mo ● Medicaid $600/mo ● WIC $75/mo Cliff Points: ! At $32,150 → lose SNAP (-$4,140/yr) ! At $34,279 → lose Medicaid (-$7,200/yr) Safe raise target: $42,000

cost estimator

$ pigeongov cost immigration/naturalization DIY (with PigeonGov): $770 - $790 With attorney: $2,270 - $8,290 You save: ~$4,500

case tracker

$ pigeongov track WAC2590123456 Receipt: WAC2590123456 Status: Case Was Approved Processing Time Estimates: 50%: 6.5 months 75%: 9.0 months 90%: 12.0 months

state tax

$ pigeongov state-tax CA --income 100000 California State Tax — Single filer, $100,000 ┌─────────────────────────────────┐ │ State taxable $94,316 │ │ State tax $6,414 │ │ Effective rate 6.41% │ │ Withholding $5,000 │ │ Owed $1,414 │ └─────────────────────────────────┘

tax/1040 — OBBB

$ pigeongov fill tax/1040 --data return.json PigeonGov v0.4.0 — tax/1040 (OBBB Act 2025) ┌────────────────────────────────────────┐ │ Gross income $158,700 │ │ Tip deduction (OBBB) -$5,000 │ │ Capital gains tax $3,300 │ │ NIIT (3.8%) $0 │ │ CTC ($2,200 × 1) -$2,200 │ │ CA state tax $8,106 │ ├────────────────────────────────────────┤ │ REFUND $5,481 │ └────────────────────────────────────────┘

Free. Open source. No upsells. No dark patterns.

No $60 to file what should cost $0.

TurboTax charges $120 and sells your data. We charge $0 and keep nothing. Government forms belong to the public. The tools to fill them should too.

36 workflows across everything the government throws at you.

Click a domain to see its workflows. Or just search.

Your AI agent's new best friend.

PigeonGov speaks MCP natively. Point your agent at it and let it handle the paperwork.

One npx pigeongov serve gives any MCP-compatible agent access to all 36 workflows, eligibility screening, life event planning, form validation, dependency graphs, benefits cliff analysis, cost estimation, USCIS case tracking, student loan advising, and state tax calculation. JSON in, JSON out. Deterministic exit codes.

Works with Claude Code, Codex, or any agent that speaks MCP. Also ships agents.json and llms.txt for discovery.

26 MCP tools JSON output Structured errors Agent guide mode

agent setup

# Add PigeonGov to Claude Code $ claude mcp add pigeongov -- npx pigeongov serve # The agent guide gives your AI the full pipeline: $ pigeongov guide Agent Pipeline: 1. list Browse available workflows 2. start Get starter data for a workflow 3. fill Fill with user data → validated bundle 4. review Check flags and suggestions # Plus intelligence tools: dependencies Cross-agency dependency graph cliff Benefits cliff calculator cost DIY vs. attorney cost estimator track USCIS case status tracker student-loans SAVE/IDR transition advisor ← NEW state-tax State income tax calculator ← NEW

Everything stays on your machine.

Your SSN, your income, your immigration status — none of it leaves your terminal. Ever.

🔒 No cloud uploads

📡 No telemetry

🗄 Encrypted local vault

Government paperwork,without the paperwork.