itr-wala
File your Indian income tax return (ITR) from your terminal. Deterministic tax engine, both regimes, AY 2026-27. Claude Code / Codex / Gemini skill.
itr-wala is an AI agent skill that enables terminal-based filing of Indian income tax returns (ITR) for assessment year 2026-27. It combines a deterministic Python tax engine with AI document reading to compute tax across both old and new regimes while ensuring mathematical accuracy through a 47-test golden suite. The skill reads Form 16 and AIS documents using the AI model, but performs all tax calculations—including surcharges, rebates, capital gains, and interest—through validated Python code that runs entirely on your machine, never allowing the AI to perform arithmetic.
Key Features
Use Cases
- 01Self-filing Indian income tax returns without hiring a chartered accountant or paying ₹3,000+ service fees
- 02Computing old vs. new regime tax liability with exact figures to choose the regime that saves the most money
- 03Preparing a reviewed first draft of tax calculations to hand to a CA for verification at lower cost
- 04Filing belated returns (until 31 December 2026) with accurate late-fee and interest computation
- 05Understanding every tax calculation through test-backed explanations rather than trusting opaque third-party software
- 06Handling complex scenarios like capital gains exemption ordering, section 71 loss set-off, and advance tax interest to actual challan dates
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
itr-wala — FAQ
What is itr-wala and how does it work?+
itr-wala is an AI agent skill that prepares Indian income tax returns by combining AI document reading with deterministic Python tax computation. The AI reads your Form 16 and AIS to extract figures, while tested Python code performs all tax calculations, ensuring accuracy through 47 golden tests and cross-validation against independent documents.
How do I install itr-wala for Claude Code?+
Clone the repository, review the code, then run './install.sh' from inside the checkout for a plain skill, or use '/plugin marketplace add karanb192/itr-wala' followed by '/plugin install itr-wala@itr-wala' in Claude Code for plugin installation. The installer copies files locally and makes no network calls, ensuring you install exactly what you reviewed.
Which AI clients work with itr-wala?+
itr-wala works with Claude Code, OpenAI Codex CLI, and Gemini CLI. You can install it as a plain skill or as a plugin/marketplace item depending on the client, and the install script supports global or project-local scope.
Do I need any API keys or prerequisites?+
You only need Python 3.9+ (stdlib only, zero pip installs) and git if fetching remotely. No API keys, no network calls during computation, and no third-party dependencies—the entire tax engine runs offline on your machine.
Is itr-wala free and can I trust it with my tax data?+
Yes, it's free and MIT-licensed. Privacy is built-in: the validator rejects PAN/Aadhaar-shaped strings, tax calculations run entirely locally, and the AI only reads documents you explicitly provide (which you can redact first). The skill never sees your portal password, OTP, or clicks Pay/Submit/e-Verify—you control those final steps.
What tax scenarios does itr-wala cover for AY 2026-27?+
It covers salary (including gratuity/leave encashment), house property with loss set-off, equity/MF/crypto capital gains, debt MF, lottery/online-game winnings, interest, dividends, family pension, arrears relief, presumptive income (44AD/ADA), all Chapter VI-A deductions, and both tax regimes. It does not handle non-residents, F&O, audit cases, or foreign tax credit, and will tell you to consult a CA for those.
How do I install itr-wala?+
Open the source repository on GitHub and follow its README. itr-wala is a skill — MCP Agents Market links you directly to the official repo.
Is itr-wala free?+
itr-wala is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.