TaxMate Australia

TaxMate Australia helps Codex, Claude Code, Cowork, and OpenAgentSkill CLI prepare Australian individual tax return materials with conservative checklists, review flags, accountant handoffs, and print-first HTML guides. It is linked to official ATO sources and keeps GST/BAS, CGT, missing evidence, and manual-copy boundaries visible.

[!WARNING] Not tax advice. TaxMate Australia is a preparation aid, not professional advice or lodgment software. For complex situations, binding decisions, or lodgment, consult a registered tax agent or use the official ATO channel directly. See DISCLAIMER.md.

Choose Your Install

Pick the smallest path that matches what you need:

Codex plugin install:

codex plugin marketplace add nijanthan-dev/taxmate-australia
codex plugin add taxmate-australia@taxmate-local-marketplace

Claude Code plugin install:

claude plugin marketplace add nijanthan-dev/taxmate-australia
claude plugin install taxmate-australia@taxmate-australia

After install, ask your agent to use TaxMate Australia to validate the runtime, create sample individual answers, or render the individual-return HTML guide.

Optional npx skills guidance-only install:

npx [email protected] add nijanthan-dev/taxmate-australia --list
npx [email protected] add nijanthan-dev/taxmate-australia \
  --agent codex --global --skill '*' --yes

Use --agent claude-code instead of --agent codex for Claude Code guidance-only skill installs. Generated files in Claude Code need the Claude Code plugin install above.

Install details: docs/INSTALLATION.md. Developer runtime details: docs/FULL_PLUGIN_INSTALL.md.

Output Handoff

The optional npx skills install produces source-backed guidance, missing-evidence prompts, and conservative Accountant review routing. It does not install the renderer and does not render files.

The plugin runtime produces a print-first HTML handoff from reviewed or user-supplied facts. Each worksheet card shows the supplied facts as labelled bullets, the next action, an exact verified myTax/paper destination or explicit non-entry/review wording, why the action applies, and its provenance. The handoff is a custom preparation aid, not an ATO form, not lodgment software, not final tax advice, and not fileable.

The runtime-owned handoff taxonomy is: enter reviewed value, answer guided question, retain evidence, resolve before entry, accountant handoff only, not entered directly, and destination requires review. Output layers render this contract and do not infer destinations from row names, broad topic links, or unverified target labels.

The current individual-return handoff includes:

• prep-only boundary and manual-copy warning;
• intake summary and AI extraction confirmation cards;
• individual return action cards with labelled fact bullets, next actions, destinations, explanations, and context links;
• primary and secondary PAYG income statement rows with payer, ABN, occupation, gross, withholding, allowances, RFBA, RESC, lump sum labels, statement evidence, and aggregate reconciliation;
• itemized private health statement lines with insurer or fund, membership or policy identifier, benefit code, premiums eligible for rebate, rebate received, tax claim code, cover days or period, statement evidence, and row-specific provenance, plus Medicare levy/surcharge, spouse, and dependant review rows;
• itemized investment income rows for bank interest, dividends/franking, managed fund/ETF/AMIT distributions, and investment trust distribution routing;
• separate individual partnership-share and trust-beneficiary statement rows, plus narrow compensation/insurance and scholarship/prize/award review routing;
• general CGT event schedule and itemized non-crypto/non-rental CGT event rows with records, current-year and carried-forward loss facts, discount, foreign-resident discount, main residence, and small-business CGT concession review signals, source provenance, reconciliation prompts, and amount-not-worked-out wording;
• itemized deduction rows for gifts/donations, tax affairs costs, income protection, self-education, union/professional fees, work travel/car/public transport, tools/equipment/assets, personal super contribution deduction prep, and offset routing, all with evidence and review queues;
• phone plan/data/device/incidental-use rows with WFH fixed-rate duplicate-claim prevention, employer paid/reimbursed/provided exclusions, evidence prompts, and ABN/GST/BAS review routing;
• ABN prep section and BAS worksheet, including ABN profile, income streams, expense categories, 1A/1B, GST-free/input-taxed sales, adjustments, PAYG labels, tax invoice evidence, and accounting-basis review;
• separate prep-only company, trust, and partnership intake sections, including company dividend/franking-account/Division 7A review, trust CGT/franked-distribution/streaming/allocation review, isolated trust-beneficiary and partnership-partner statement rows, official-source provenance, missing-evidence prompts, and accountant-review handoff; no final allocation, entitlement, CGT, franking, Division 7A, lodgment, or advice;
• missing facts queue, evidence queue, and accountant-review queue using the same row context;
• row-associated supporting provenance and verified destination-mapping sources.

Preview

Example guide from synthetic sample data. Shows the overview, prep boundary, handoff taxonomy, action-card index, and Accountant review boundary. Not an ATO form. Not fileable.

The worksheet preview shows itemized private health statement, Medicare levy, surcharge, and spouse facts as labelled bullets. Each card keeps its next action, destination or explicit review wording, explanation, and provenance together. The generated HTML also covers dependant, investment, deduction, super, offset, CGT, ABN, BAS, missing-fact, evidence, and accountant-review rows.

The sample data is synthetic. Screenshot maintenance is a contributor task documented in docs/DEVELOPMENT.md.

What It Does

• Helps users prepare PAYG income statements, itemized private health statement and Medicare/spouse/dependant review facts, ABN/sole-trader facts, GST/BAS facts, investment statements, general CGT event and main residence exemption claim facts, rental property facts, crypto events, deductions, superannuation, offsets, and other individual-return material.
• Keeps next actions, verified destinations or explicit review wording, missing-evidence prompts, review queues, and conservative Accountant review flags visible.
• Keeps source URLs, checked-at dates, source coverage checks, and generated topic skills visible.
• Audits verified source coverage against runtime/docs/tests status with ./scripts/taxmate coverage audit.
• Builds taxpack and print-first HTML guide handoffs from reviewed data.
• Helps users manually copy reviewed answers into myTax, paper ATO forms, or an accountant handoff. TaxMate does not fill official ATO PDFs or create returns users can submit directly to the ATO.

Use It

Start with the outcome, not an internal command. For a broad individual return, Individual Return Prep shows the guidance-only skill path, the plugin HTML guide path, and the prep-only boundaries for myTax, paper ATO form, or accountant handoff.

Talk to the agent in natural language. TaxMate works best when the user describes the income year, the return sections involved, the facts they have, and what they want prepared. The agent can use a specific guidance skill when the topic is clear, or use the installed plugin when you want a rendered HTML handoff.

Broad prep examples:

Help me prepare my 2025-26 Australian individual tax return. Ask for the facts you need, keep missing evidence visible, and flag anything that needs accountant review.

I have PAYG income statements, some bank interest and dividends, and a small ABN side business. Help me prepare a prep-only individual tax return review checklist for myTax or my accountant.

I am GST registered and have ABN income, expenses, tax invoices, and BAS period facts. Use the taxmate-australia-individual-return, taxmate-australia-abn-business, and taxmate-australia-gst-bas skills to prepare the income-tax and BAS review items without treating anything as lodged or final.

Topic examples:

Use the taxmate-australia-individual-return skill to prepare PAYG income statement rows from these employer statements, keep payer ABNs, gross, withholding, allowances, RFBA, RESC, lump sum labels, statement evidence, and reconciliation gaps visible.

Use the taxmate-australia-individual-return skill to prepare investment income rows from my bank interest, dividend/franking, managed fund/ETF/AMIT, and trust distribution statements.

Use the taxmate-australia-individual-return skill to prepare my individual partnership-share or trust-beneficiary statement facts separately from managed fund/ETF/AMIT distributions. Preserve statement components, losses, withholding, credits, source links, and evidence gaps. Route uncommon compensation, insurance, scholarship, prize, award, or unsupported income to prep-only review; do not prepare an entity return or decide allocations.

For an entity return, provide supplied facts, records, source links, checked-at dates, and review signals. Company inputs may include income/deductions, losses, assets, dividends, franking-account movements, and Division 7A facts. Trust inputs may include capital-gain components, CGT discount signals, franked distributions and franking credits, deed/streaming/resolution facts, and beneficiary component allocations. Partnership inputs may include income/deductions, trading stock, capital allowances, loss/allocation, GST/BAS, PSI, and structure facts. TaxMate keeps rows in the matching entity output, preserves missing resolutions, unknown amounts, unsupported allocations, and uncertainty, and does not calculate a final return position, decide CGT/franking/streaming/allocation treatment, determine PSI, lodge BAS, or lodge a return.

Use the taxmate-australia-private-health-medicare skill to prepare separate private health statement lines from my insurer details, membership number, benefit codes, premiums eligible for rebate, rebate received, tax claim codes, cover days or periods, and statement evidence. Keep Medicare levy exemption or reduction signals, Medicare levy surcharge review facts, spouse periods and income-test facts, dependant child or student facts, missing evidence, false/zero values, source URLs, and checked-at dates visible. Do not calculate levy, surcharge, rebate, tax claim code, or final entitlement.

Use the taxmate-australia-individual-return skill to prepare itemized deduction rows from my gifts, tax agent fees, income protection, self-education, union fees, work travel, tools/assets, personal super contribution deduction facts, and offset signals. Keep receipts, reimbursements, employer-paid/provided flags, work/private splits, GST/BAS overlap, duplicate-risk, notice of intent, fund acknowledgement, cap/Division 293 review, and source provenance visible.

Use the taxmate-australia-individual-return skill to prepare itemized CGT event review rows from my asset list, owners, acquisition and disposal dates, proceeds, cost base, incidental costs, current-year and carried-forward capital loss facts, discount timing or review signals, foreign-resident discount signals, small-business concession claim facts, concession type, active asset and entity/affiliate/connected entity facts, records, and review flags. Reconcile supplied totals only as prep evidence. Do not work out capital gain/loss amounts or concession amounts.

Use the taxmate-australia-capital-gains-tax skill to review this asset disposal conservatively. Include any main residence claim facts, ownership and occupancy periods, rental/business use, absence periods, spouse/partner main-residence conflicts, small-business concession signals, property records, and rental-property overlap signals. Show the facts still needed before anyone relies on the CGT treatment; do not work out exemption or concession amounts.

Use the taxmate-australia-individual-return skill to prepare a rental property worksheet from my rent, loan interest, repairs, private use, depreciation, records, and net rental loss facts.

Use the taxmate-australia-gst-bas skill to review my 1A GST collected, 1B GST credits, GST-free/input-taxed sales, adjustments, PAYG labels, tax invoices, accounting basis, and BAS period. Identify missing evidence and accountant-review items only; do not lodge anything.

Use the taxmate-australia-work-from-home skill for the 2025-26 income year and verify current rates before calculating anything.

HTML handoff examples:

Use the installed TaxMate Australia plugin to prepare the print-first individual return HTML guide from my reviewed answers, then tell me where the file is so I can open it and save it as PDF from my browser.

I have a reviewed answers file. Use TaxMate to create the prep-only HTML handoff with AI confirmation cards, labelled fact bullets, next actions, verified destinations or explicit review wording, PAYG rows, private health statement and Medicare/spouse/dependant review rows, investment rows, deduction/super/offset rows, CGT schedule and item rows, detailed ABN prep, BAS worksheet, review queues, and source/provenance appendix.

If you are using npx skills guidance only, the agent can build the checklist, review prompts, manual-copy guidance, and source-backed review flags in chat. Rendering the HTML file needs the plugin runtime.

Plugin Runtime Quickstart

Plugin install is the real TaxMate install. Use it when you need generated guides, workbook/taxpack output, source refresh, finance review, or calculators.

Prerequisites:

• Codex or Claude Code.
• Node.js 20+ for the MCP launcher.
• Bash and Python 3.9+ for the plugin runtime.

Install for Codex:

codex plugin marketplace add nijanthan-dev/taxmate-australia
codex plugin add taxmate-australia@taxmate-local-marketplace

Install for Claude Code:

claude plugin marketplace add nijanthan-dev/taxmate-australia
claude plugin install taxmate-australia@taxmate-australia

Setup details: docs/INSTALLATION.md.

Ask your agent to use the TaxMate Australia tools:

Use TaxMate Australia to validate the runtime.

Use TaxMate Australia to write sample individual answers and render the individual-return HTML guide.

Export reviewed guide/intake JSON as deterministic CSV workbook tabs:

./scripts/taxmate workbook --input /tmp/taxmate-reviewed.json --output /tmp/taxmate-workbook

The export accepts reviewed guide JSON or raw intake answers; separates employee, ABN, BAS, investment, super, private-health, property, CGT, other, evidence, accountant-review, and source tabs; and neutralizes formula-like CSV cells. It preserves Accountant review, Evidence, falsey values, source URLs, and checked-at dates. It is a preparation aid only, not a final return or lodgment file.

Open the HTML in a browser and use print/save as PDF. The printed PDF keeps each action card together where possible and hides navigation controls. Rows can include source_url, source_urls, and checked_at; the guide keeps supporting provenance separate from verified destination-mapping provenance.

Developer fallback from a cloned repository is documented in docs/FULL_PLUGIN_INSTALL.md.

Skills Included

Public guidance skill entry points:

• taxmate-australia
• taxmate-australia-individual-return
• taxmate-australia-employment-deductions
• taxmate-australia-work-from-home
• taxmate-australia-abn-business
• taxmate-australia-gst-bas
• taxmate-australia-payg-employer
• taxmate-australia-capital-gains-tax
• taxmate-australia-shares-etfs-managed-funds
• taxmate-australia-crypto-assets
• taxmate-australia-property-rental-cgt
• taxmate-australia-superannuation
• taxmate-australia-private-health-medicare
• taxmate-australia-records-evidence
• taxmate-australia-workbook
• taxmate-australia-taxpack

Source artifacts are tracked in data/ato_knowledge_base/source_coverage.json, derived from data/ato_knowledge_base/source_registry.json.

Development

Contributor flow, release checks, screenshot maintenance, and repository validation rules: docs/DEVELOPMENT.md.

Troubleshooting

• Plugin install fails: verify Codex or Claude Code is installed with Node.js 20+, then re-run the matching plugin install commands in docs/INSTALLATION.md.
• node: command not found: install Node.js 20+ so the plugin MCP launcher can start.
• HTML guide command fails: ask Codex to run TaxMate runtime validation and verify python3 + bash are available.
• npx: command not found: install Node.js 20+. The plugin needs Node.js for MCP startup; npx is only for optional guidance-only skill installs.
• Need guidance only: use the optional npx skills commands in docs/INSTALLATION.md.

More Docs

• Install: docs/INSTALLATION.md
• Developer runtime fallback: docs/FULL_PLUGIN_INSTALL.md
• Development: docs/DEVELOPMENT.md
• Discovery metadata: docs/DISCOVERY.md
• Skill generation: docs/SKILL_GENERATION.md
• Disclaimer: DISCLAIMER.md