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. The handoff is a custom preparation aid, not an ATO form, not lodgment software, not final tax advice, and not fileable. Users manually copy reviewed values into myTax, paper ATO forms, or an accountant handoff after evidence and review queues are resolved.

The current individual-return handoff includes:

• prep-only boundary and manual-copy warning;
• intake summary and AI extraction confirmation table;
• individual return field guide;
• 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 investment income rows for bank interest, dividends/franking, managed fund/ETF/AMIT distributions, and trust distribution 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;
• 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;
• missing facts queue, evidence queue, and accountant-review queue;
• source/provenance appendix with source URLs and checked-at dates.

Preview

Example guide from synthetic sample data. Shows the overview, prep boundary, manual-copy warning, AI extraction confirmation table, field guide rows, PAYG income statement rows, investment income prep rows, evidence prompts, and Accountant review flags. Not an ATO form. Not fileable.

The lower handoff preview shows the evidence queue, accountant-review queue, row-level provenance, and the source/provenance appendix. The generated HTML also includes ABN prep, BAS worksheet, and missing-facts sections above this section.

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, ABN/sole-trader facts, GST/BAS facts, investment statements, general CGT event and main residence exemption claim facts, rental property facts, crypto events, superannuation, private health, and other individual-return material.
• Keeps missing-evidence prompts, review queues, source-backed notes, and conservative Accountant review flags visible.
• Keeps source URLs, checked-at dates, source coverage checks, and generated topic skills visible.
• 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 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 the AI confirmation table, PAYG rows, investment 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, 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.

Open the HTML in a browser and use print/save as PDF. The printed PDF keeps the same guide layout and hides the preview toolbar. Rows can include source_url, source_urls, and checked_at; the guide keeps those provenance fields visible in the worksheet.

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 guardrails: 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