netlify-axi

An AXI-compliant wrapper around the Netlify CLI — token-efficient TOON output, structured errors, and agent-first ergonomics for AI coding agents that operate Netlify via shell.

Built on axi-sdk-js, modeled on the reference implementation gh-axi.

Status

Early scaffold (v0). Read-only commands only.

Requirements

• Node.js >= 20
• The Netlify CLI installed and logged in (netlify login)

Install

Not on npm yet, so npx -y netlify-axi does not work. Install from a clone:

git clone https://github.com/simkimsia/netlify-axi
pnpm --prefix netlify-axi install
pnpm --prefix netlify-axi run build
pnpm --prefix netlify-axi link --global   # puts `netlify-axi` on PATH

Check it: netlify-axi --version. To update later, git pull in the clone and run the build step again.

Usage

netlify-axi            # dashboard: linked site, or most recent sites
netlify-axi list       # all sites you have access to
netlify-axi status     # site linked to the current directory
netlify-axi whoami     # logged-in Netlify account
netlify-axi --help
netlify-axi --version  # fast path, never loads the command graph
netlify-axi update     # self-update (built into axi-sdk-js)

Example output (TOON):

count: 5 sites
sites[5]{name,team,url,updated}:
  my-app,Acme,https://my-app.netlify.app,3d ago
  ...
help[2]:
  Run `netlify link` in a project directory to link a site
  Run `netlify-axi status` to see the linked site

Agent skill

Install the bundled skill so your coding agent prefers netlify-axi over raw netlify, falls back to netlify when a command is not wrapped yet, and files the gap as an issue here (label agent-reported-gap):

npx skills add simkimsia/netlify-axi --skill netlify-axi -g

The skill is a discovery stub that defers to netlify-axi --help for current command guidance. Source: skills/netlify-axi/SKILL.md.

Development

pnpm install
pnpm run dev          # run from source (tsx)
pnpm test             # vitest
pnpm run build        # tsc -> dist/
pnpm run format:check

License

MIT