Skip to content

jyswee/atx-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

atx — AITaxAdvise CLI

AI-powered tax research from your terminal. Ask tax questions, get cited legislation. Zero dependencies.

Built for coding agents and developers.

Install

npm install -g aitaxadvise

Quick Start

# Create an account
atx signup my-firm --local

# Ask a tax question
atx ask "UK CGT on residential property sale 2025-26"

# Check your balance
atx balance

Commands

Command Description
atx signup <slug> Create account, get API key instantly
atx login --key <key> Save API key to config
atx ask "query" Ask a tax research question
atx ask "query" --json Get raw JSON response (for piping)
atx balance Check remaining research sessions
atx history View recent research sessions
atx me Show account info
atx topup Request credits (shows payment URL)
atx --help Show all commands

Examples

# UK tax
atx ask "I earn £85,000 as a PAYE employee. What is my income tax?"
atx ask "SDLT on sale-and-leaseback with 999-year leases under s57A"

# Malta tax
atx ask "Malta corporate tax refund system 6/7ths effective rate"
atx ask "Global Residence Programme 15% flat rate conditions"

# Cross-border
atx ask "UK resident relocating to Malta. Company worth £3M. CGT and DTA implications?"

# JSON output (for agents)
atx ask "UK VAT flat rate scheme for IT consultancy" --json

Agent Integration

Add to your project rules file (.cursorrules, .clinerules, .windsurfrules, etc.):

## AITaxAdvise
Use the atx CLI for tax research.
API key is in .atx/config.json (auto-loaded).
- `atx ask "your tax question"` — get cited tax research
- `atx balance` — check remaining sessions
- `atx --help` — full reference

Configuration

Config is resolved in this order:

  1. --key flag (highest priority)
  2. ATX_API_KEY environment variable
  3. .atx/config.json (project-scoped)
  4. ~/.atx/config.json (global)
# Project-scoped (recommended for repos)
atx login --key atx_xxx --local    # saves to .atx/config.json

# Global (shared across projects)
atx login --key atx_xxx            # saves to ~/.atx/config.json

Add .atx/ to your .gitignore.

Coverage

  • UK: 39,208 rules across 53 HMRC manuals (Income Tax, CGT, SDLT, IHT, VAT, Corporate, Pensions, Crypto, Expat, Compliance)
  • Malta: Corporate tax, refund system, GRP, HQP, VAT, Property, DTA
  • Cross-border: UK-Malta, UK-UAE, UK-EU relocations and double tax treaties

How It Works

  1. Your query is analysed and classified across 10 tax domains
  2. Routed to the most relevant knowledge base sections
  3. Multiple specialist agents research in parallel
  4. Response cites specific legislation (FA 2003 s57A, TCGA 1992, etc.)
  5. Verified for rate accuracy before delivery

All for the cost of one research session.

Pricing

  • First session: £1 ($1 verification)
  • Single session: £23.99
  • 5-Pack: £95.99 (save 20%)
  • 10-Pack: £159.99 (save 33%)

Support


Tax information only. Not regulated tax advice. Full disclaimer

(c) Tyga.Cloud Ltd (UK #14643275) | aitaxadvise.com

Releases

No releases published

Packages

 
 
 

Contributors