{ "version": "2", "generatedAt": "2026-11-03T22:49:39.280Z", "listing": { "slug": "karanb192--itr-wala", "name": "itr-wala", "tagline": "Claude Code, Codex and Gemini skill that prepares an Indian income tax return with a tested tax engine.", "shortTagline": "Indian income tax return skill", "description": "itr-wala is an agent skill: the model reads Form 16, AIS and broker statements, a deterministic Python engine computes both regimes, surcharge, interest and late fees for AY 2026-27, and the agent walks you through the government portal. It never pays, submits or e-verifies. Installs as a skill or plugin with zero dependencies; MIT.", "capabilities": [ "adaptable", "operable" ], "vertical": "invoicing-finance", "alternativeTo": [ "ClearTax" ], "shape": "skill", "formFactor": "skill", "executionModel": "hybrid", "provenance": "unknown", "codeStack": { "languages": [ "Python", "Shell" ], "frameworks": [], "packageManager": null, "database": [], "hostingTarget": [ "local machine (~/.claude/skills, ~/.codex/skills, ~/.gemini/skills)" ] }, "modelStack": { "providers": [ "whichever agent runs the skill (Claude Code, Codex, Gemini CLI)" ], "models": [], "requiredKeys": [], "promptLocations": [ "skills/itr-wala/SKILL.md" ], "tools": [ "scripts/tax_engine.py", "scripts/validate_income.py", "scripts/test_tax_engine.py" ] }, "repos": [ { "url": "https://github.com/karanb192/itr-wala", "owner": "karanb192", "name": "itr-wala", "license": "MIT", "stars": 846, "lastCommit": "2026-09-02" } ], "interface": { "kind": "cli", "url": "https://github.com/karanb192/itr-wala", "official": true, "hosted": "local" }, "operability": "native", "recommendedWrapper": null, "reach": [ { "job": "Self-test the tax engine", "reachable": true, "evidence": "scripts/test_tax_engine.py, 47 golden tests run at session start" }, { "job": "Extract figures from Form 16, AIS and broker P&L", "reachable": true, "evidence": "the model transcribes into income.json (README session step 3)" }, { "job": "Validate inputs and cross-check TDS against 26AS/AIS", "reachable": true, "evidence": "validate_income.py; rejects PAN-shaped strings" }, { "job": "Hunt for missed deductions", "reachable": true, "evidence": "proactive interview step in SKILL.md flow" }, { "job": "Compute both regimes and recommend", "reachable": true, "evidence": "tax_engine.py output shown in README" }, { "job": "Select the ITR form and build a filing pack", "reachable": true, "evidence": "README: ITR-1/2/3/4 selection, portal field mapping" }, { "job": "Walk through the portal schedules", "reachable": true, "evidence": "README: it narrates each schedule; you type" }, { "job": "Pay, submit and e-verify", "reachable": false, "evidence": "hard boundary by design: never clicks Pay, Submit or e-Verify" }, { "job": "Non-resident, F&O, audit cases, foreign tax credit", "reachable": false, "evidence": "README out-of-scope list; it refers you to a CA" } ], "editions": [ { "name": "Free", "price": null, "open": true, "distributions": [ { "kind": "source", "url": "https://github.com/karanb192/itr-wala" }, { "kind": "installable", "url": "https://skills.sh/karanb192/itr-wala", "command": "npx skills add karanb192/itr-wala" } ] } ], "skills": { "kind": "pure", "paths": [ "skills/itr-wala/SKILL.md", ".claude-plugin/" ], "install": "npx skills add karanb192/itr-wala", "note": "Repo is one tax-filing skill packaged as a Claude Code and Codex plugin; scripts/ are helpers the skill invokes." }, "customization": { "summary": "Fork, review, and pin: DEFAULT_REPO in install.sh points the installer at your fork, ITR_WALA_REF pins a commit. The behavior you would change is in SKILL.md (interview flow, portal notes) and the rate constants block in scripts/tax_engine.py, each change shipping with a hand-derived test by project rule.", "envVars": [ "ITR_WALA_REF", "ITR_WALA_NO_FETCH", "ITR_WALA_REPO" ], "configFiles": [ "install.sh (DEFAULT_REPO)" ], "promptFiles": [ "skills/itr-wala/SKILL.md" ], "effort": "light-edit", "editCount": 5 }, "useWhen": [ "I file my own Indian return and want every rupee computed by tested code before I touch the portal", "I am a CA who wants a zero-cost first draft and filing pack from a client's Form 16" ], "accounts": [ "Claude Code, Codex or Gemini CLI", "Income Tax e-filing portal account (you file; the tool does not)" ], "active": true, "lastActivity": "2026-09-02", "gotchas": [ "India only, resident individuals, AY 2026-27 only; refuses other years", "Documents you hand the model leave your machine; redact PAN and Aadhaar first (the validator enforces it)", "Original due dates have passed; belated filing until December 31, 2026 with a late fee" ], "fit": { "adaptable": 2, "operable": 3 }, "evidence": { "formFactor": "skills/itr-wala/SKILL.md plus scripts; installs into agent skill directories", "executionModel": "model reads documents and interviews; Python does every calculation (README table)", "operability": "built as a skill for the agent; the agent is the primary interface", "effort": "SKILL.md and tax_engine.py constants are the editable files; env vars only affect install", "editions": "LICENSE file is MIT (GitHub shows NOASSERTION)", "active": "GitHub pushedAt 2026-09-02; Show HN 2026-07-28; Instagram reel drove 1.2M views" }, "confidence": { "formFactor": 0.95, "executionModel": 0.95, "operability": 0.9, "effort": 0.8, "reach": 0.9, "editions": 0.95 }, "openQuestions": [ "Whether the constants block is a separate file or inline in tax_engine.py" ], "sources": [ { "url": "https://github.com/karanb192/itr-wala", "foundBy": "sourcing:invoicing-finance:community" }, { "url": "https://github.com/karanb192/itr-wala/blob/main/LICENSE", "foundBy": "analysis:invoicing-finance" } ], "research": { "stage": "verified", "verdict": "unverified", "reason": "Native operability with complete in-scope Reach and honest hard boundaries. Adaptable 2 at light-edit: the surface is SKILL.md and the rate constants, not config.", "disputed": [] }, "url": "apps/karanb192--itr-wala.html", "coverage": "partial", "paid": false, "source": "research/verified/karanb192--itr-wala.json" } }