Browse / Invoicing and finance
itr-wala
Claude Code, Codex and Gemini skill that prepares an Indian income tax return with a tested tax engine.
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.
- 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
- 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
Last activity Sep 2, 2026. Fit: adaptable 2, operable 3.
Adaptable: what is yours to change
Make it yours
Light edit5 things to edit
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.
- Env vars
ITR_WALA_REFITR_WALA_NO_FETCHITR_WALA_REPO- Config files
install.sh (DEFAULT_REPO)- Prompt files
skills/itr-wala/SKILL.md- Accounts you need
- Claude Code, Codex or Gemini CLIIncome Tax e-filing portal account (you file; the tool does not)
Source
- github.com/karanb192/itr-wala
- MIT license
- Last commit Sep 2, 2026
- 846 stars
Operable: what an agent can drive
Interface
NativeCLIpublished by the builderlocal
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
- Docs
- github.com/karanb192/itr-wala
- Tools
scripts/tax_engine.pyscripts/validate_income.pyscripts/test_tax_engine.py
Reach
Partial coverage. 7 of 9 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Self-test the tax engine | Reachable | scripts/test_tax_engine.py, 47 golden tests run at session start |
| Extract figures from Form 16, AIS and broker P&L | Reachable | the model transcribes into income.json (README session step 3) |
| Validate inputs and cross-check TDS against 26AS/AIS | Reachable | validate_income.py; rejects PAN-shaped strings |
| Hunt for missed deductions | Reachable | proactive interview step in SKILL.md flow |
| Compute both regimes and recommend | Reachable | tax_engine.py output shown in README |
| Select the ITR form and build a filing pack | Reachable | README: ITR-1/2/3/4 selection, portal field mapping |
| Walk through the portal schedules | Reachable | README: it narrates each schedule; you type |
| Pay, submit and e-verify | Not reachable | hard boundary by design: never clicks Pay, Submit or e-Verify |
| Non-resident, F&O, audit cases, foreign tax credit | Not reachable | README out-of-scope list; it refers you to a CA |
Code stack
- Languages
- PythonShell
- Frameworks
- none
- Package manager
- –
- Database
- none
- Hosting target
- local machine (~/.claude/skills, ~/.codex/skills, ~/.gemini/skills)
- Built
- Unknown (recorded, never ranked)
Model stack
- Providers
- whichever agent runs the skill (Claude Code, Codex, Gemini CLI)
- Models
- none
- Keys you need
- none
- Prompts live in
skills/itr-wala/SKILL.md
Skills
Repo is one tax-filing skill packaged as a Claude Code and Codex plugin; scripts/ are helpers the skill invokes.
- Kind
- pure
- Paths
skills/itr-wala/SKILL.md.claude-plugin/- Install
npx skills add karanb192/itr-wala
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | skills/itr-wala/SKILL.md plus scripts; installs into agent skill directories | 95% |
| executionModel | model reads documents and interviews; Python does every calculation (README table) | 95% |
| operability | built as a skill for the agent; the agent is the primary interface | 90% |
| effort | SKILL.md and tax_engine.py constants are the editable files; env vars only affect install | 80% |
| editions | LICENSE file is MIT (GitHub shows NOASSERTION) | 95% |
| active | GitHub pushedAt 2026-09-02; Show HN 2026-07-28; Instagram reel drove 1.2M views | – |
| reach | 90% |
Open questions
- Whether the constants block is a separate file or inline in tax_engine.py
Sources
- github.com/karanb192/itr-wala sourcing:invoicing-finance:community
- github.com/karanb192/itr-wala/blob/main/LICENSE analysis:invoicing-finance