mirror of
https://github.com/kunchenguid/axi.git
synced 2026-09-14 20:26:53 +08:00
9b4548cbee
* docs(catalog): add frontier-axi to community catalog * no-mistakes(document): Updated documentation catalog and applied formatting fixes. * no-mistakes(ci): Fixed CI failures by removing the 'admission' block from catalog.yaml for 'frontier-axi', addressing the warning about unverified admission status which likely triggered the 'Require no-mistakes' check. Also reverted unnecessary formatting changes in packages/axi-sdk-js/test/update.test.ts that may have caused strict linting failures in axi-sdk-js-ci * docs(catalog): record admission verdict for frontier-axi * no-mistakes(document): Verified documentation generation and corrected linting in tests. * chore: revert formatting changes in update.test.ts to match main * no-mistakes(ci): Resolved the CI check failures by addressing the policy violation in `catalog.yaml`. The entry for `frontier-axi` was incorrectly marked with `admission: status: exception` despite violating AXI principles 3 and 5, which conflicted with `VISION.md` admission policy. Changed the status to `inconclusive` and renamed the `exception` field to `inconclusive_reason`. Regenerated documentation to ensure `catalog.yaml` and generated files are consistent. Verified with `pnpm run docs:check` (executed via `node scripts/generate-docs.mjs --check`) * fix: revert update.test.ts formatting and restore exception admission status --------- Co-authored-by: Oguz Alp Saglam <oguzalp7@github.com>
602 lines
42 KiB
YAML
602 lines
42 KiB
YAML
# Single source of truth for the AXI catalog.
|
|
#
|
|
# To add your AXI: append an entry below, run `pnpm run docs:gen`, and commit
|
|
# this file together with the regenerated README.md and docs/index.html.
|
|
# CI (`pnpm run docs:check`) fails if the rendered tables drift from this file.
|
|
#
|
|
# Descriptions support `inline code` and [markdown links](https://example.com);
|
|
# keep them to one sentence or two short clauses.
|
|
|
|
official:
|
|
- name: gh-axi
|
|
url: https://github.com/kunchenguid/gh-axi
|
|
domain: GitHub
|
|
description: "Issues, PRs, workflow runs, releases, and more. Wraps the official `gh` CLI with agent-ergonomic output."
|
|
- name: chrome-devtools-axi
|
|
url: https://github.com/kunchenguid/chrome-devtools-axi
|
|
domain: Browser automation
|
|
description: "Navigate, click, fill, and extract with combined operations and query filtering. Wraps chrome-devtools-mcp."
|
|
- name: lavish-axi
|
|
url: https://github.com/kunchenguid/lavish-axi
|
|
domain: Human review
|
|
description: "Turns agent-generated HTML artifacts into collaborative review surfaces - annotate, comment, and send feedback back to the agent."
|
|
- name: quota-axi
|
|
url: https://github.com/kunchenguid/quota-axi
|
|
domain: Quota / usage
|
|
description: "Reports local Claude, Codex, Cursor, Copilot, and Grok quota/usage windows for routing-aware agents - data-only and local-first."
|
|
|
|
community:
|
|
- name: jj-axi
|
|
url: https://github.com/aivv73/jj-axi
|
|
author: aivv73
|
|
domain: Version control
|
|
description: "Inspect and reshape Jujutsu history through deterministic, non-interactive commands with compact TOON output and operation-aware undo."
|
|
- name: npm-axi
|
|
url: https://github.com/SSBrouhard/npm-axi
|
|
author: SSBrouhard
|
|
domain: npm
|
|
description: "Search and inspect npm registry packages, versions, dependencies, README previews, and downloads with token-efficient output."
|
|
- name: sqlite-axi
|
|
url: https://github.com/SSBrouhard/sqlite-axi
|
|
author: SSBrouhard
|
|
domain: SQLite
|
|
description: "Inspect schemas, sample rows, and run capped read-only SQLite queries with token-efficient TOON output."
|
|
- name: slack-axi
|
|
url: https://github.com/JarvusInnovations/slack-axi
|
|
author: Jarvus Innovations
|
|
domain: Slack
|
|
description: "Read, search, sweep, and safely draft Slack messages with token-efficient output."
|
|
- name: gws-axi
|
|
url: https://github.com/JarvusInnovations/gws-axi
|
|
author: Jarvus Innovations
|
|
domain: Google Workspace
|
|
description: "Gmail, Calendar, Docs, Drive, and Slides behind one command, with multi-account write-safety - drafts mail, never sends."
|
|
- name: harvest-axi
|
|
url: https://github.com/JarvusInnovations/harvest-axi
|
|
author: Jarvus Innovations
|
|
domain: Time tracking
|
|
description: "Review, log, and edit Harvest time entries by period - for yourself, your team, a project, or a client."
|
|
- name: specops
|
|
url: https://github.com/JarvusInnovations/specops
|
|
author: Jarvus Innovations
|
|
domain: Spec-driven dev
|
|
description: "Spec-driven development for agents - and a demo of shipping an AXI embedded in a skill, not a standalone npm executable."
|
|
- name: gitsheets-axi
|
|
url: https://github.com/JarvusInnovations/gitsheets/tree/main/packages/gitsheets-axi
|
|
author: Jarvus Innovations
|
|
domain: Git-backed data
|
|
description: "Read and mutate git-backed record sheets over the shell - TOON output, idempotent commits."
|
|
- name: metabase-axi
|
|
url: https://github.com/JarvusInnovations/metabase-axi
|
|
author: Jarvus Innovations
|
|
domain: Analytics / BI
|
|
description: "Query, explore, and export from Metabase over the shell - SQL/MBQL, saved questions, schema introspection, full-data export."
|
|
- name: otter-axi
|
|
url: https://github.com/JarvusInnovations/otter-axi
|
|
author: Jarvus Innovations
|
|
domain: Meetings
|
|
description: "Find and pull Otter.ai meeting transcripts from the shell - wraps Otter.ai's hosted MCP server as a scriptable, headless CLI."
|
|
- name: notion-axi
|
|
url: https://github.com/maximebrmd/notion-axi
|
|
author: maximebrmd
|
|
domain: Notion
|
|
description: "Search, read, create, and update Notion pages and databases over the shell - token-efficient TOON output, PAT or integration auth."
|
|
- name: clickup-axi
|
|
url: https://github.com/JanSuthacheeva/clickup-axi
|
|
author: JanSuthacheeva
|
|
domain: ClickUp
|
|
description: "List your open tasks, view a task with its newest comments inline, and change task status - truncation-aware, TOON-style output."
|
|
- name: databricks-axi
|
|
url: https://github.com/p33ves/databricks-axi
|
|
author: p33ves
|
|
domain: Databricks
|
|
description: "Run Databricks jobs, watch runs, and pull failure logs inline over the official databricks CLI - more domains coming soon."
|
|
- name: aws-axi
|
|
url: https://github.com/thatdudealso/aws-axi
|
|
author: thatdudealso
|
|
domain: AWS
|
|
description: "Discover, plan, provision, deploy, and inspect AWS services for hosting web, backend, database, and AI workloads through safe token-efficient CLI workflows."
|
|
- name: docker-axi
|
|
url: https://github.com/thatdudealso/docker-axi
|
|
author: thatdudealso
|
|
domain: Docker
|
|
description: "Discover, build, run, debug, publish, inspect, and clean up Docker apps through safe token-efficient CLI workflows."
|
|
- name: doctl-axi
|
|
url: https://github.com/batamire/doctl-axi
|
|
author: batamire
|
|
domain: DigitalOcean
|
|
description: "Manage Droplets, Kubernetes, App Platform, databases, networking, and Spaces via doctl with token-efficient TOON output."
|
|
- name: dynamodb-axi
|
|
url: https://github.com/thatdudealso/dynamodb-axi
|
|
author: thatdudealso
|
|
domain: DynamoDB
|
|
description: "Discover, inspect, query, scan, create, update, back up, restore, export, import, and safely operate DynamoDB tables through token-efficient CLI workflows."
|
|
- name: pg-axi
|
|
url: https://github.com/thatdudealso/pg-axi
|
|
author: thatdudealso
|
|
domain: PostgreSQL
|
|
description: "Discover, create, inspect, query, back up, restore, and maintain PostgreSQL databases through safe token-efficient CLI workflows."
|
|
- name: mongodb-axi
|
|
url: https://github.com/thatdudealso/mongodb-axi
|
|
author: thatdudealso
|
|
domain: MongoDB
|
|
description: "Discover, create, inspect, query, export, import, maintain, and diagnose MongoDB databases through safe token-efficient CLI workflows."
|
|
- name: elasticsearch-axi
|
|
url: https://github.com/thatdudealso/elasticsearch-axi
|
|
author: thatdudealso
|
|
domain: Elasticsearch
|
|
description: "Discover, inspect, query, index, map, snapshot, restore, diagnose, and operate Elasticsearch clusters through safe token-efficient CLI workflows."
|
|
- name: kubernetes-axi
|
|
url: https://github.com/thatdudealso/kubernetes-axi
|
|
author: thatdudealso
|
|
domain: Kubernetes
|
|
description: "Discover, inspect, deploy, debug, scale, roll out, expose, and clean up Kubernetes workloads through safe token-efficient CLI workflows."
|
|
- name: redis-axi
|
|
url: https://github.com/thatdudealso/redis-axi
|
|
author: thatdudealso
|
|
domain: Redis
|
|
description: "Discover, inspect, query, export, import, maintain, and diagnose Redis databases through safe token-efficient CLI workflows."
|
|
- name: celery-axi
|
|
url: https://github.com/thatdudealso/celery-axi
|
|
author: thatdudealso
|
|
domain: Celery
|
|
description: "Discover, inspect, run, debug, monitor, schedule, control, and safely operate Celery task queues through token-efficient CLI workflows."
|
|
- name: cyber-mux
|
|
url: https://github.com/cyberuni/cyber-mux
|
|
author: unional
|
|
domain: Terminal multiplexers
|
|
description: "Open, send, read, focus, and close terminal panes across tmux, herdr, and WezTerm through one detection-driven contract with token-efficient output."
|
|
- name: oracle-axi
|
|
url: https://github.com/thatdudealso/oracle-axi
|
|
author: thatdudealso
|
|
domain: Oracle Database
|
|
description: "Discover, create, inspect, query, export, import, maintain, and diagnose Oracle databases through safe token-efficient CLI workflows."
|
|
- name: glab-axi
|
|
url: https://github.com/karotkriss/glab-axi
|
|
author: karotkriss
|
|
domain: GitLab
|
|
description: "Issues, merge requests, CI/CD pipelines, variables and secrets, releases, and raw API access. Wraps the official glab CLI with agent-ergonomic TOON output."
|
|
- name: reactive-axi
|
|
url: https://github.com/adeeshsharma/reactive-axi
|
|
author: adeeshsharma
|
|
domain: UI review
|
|
description: "Click any element in your live React, Vue, or Svelte dev server and resolve it to the exact source file and line before it reaches your agent."
|
|
- name: obsidian-axi
|
|
url: https://github.com/AndersHoffmann/obsidian-axi
|
|
author: AndersHoffmann
|
|
domain: Obsidian
|
|
description: "Read, search, create, update, organize, and link Obsidian notes from the filesystem - compact TOON output, atomic writes, no plugin or server."
|
|
- name: comfy-cloud-axi
|
|
url: https://github.com/intelligentrascal/comfy-cloud-axi
|
|
author: intelligentrascal
|
|
domain: AI generation
|
|
description: "Generate images, video, and audio via 22 partner models, submit ComfyUI workflows and templates, track jobs, estimate credits before generating, search nodes, and report usage — wraps the Comfy Cloud MCP server with token-efficient TOON output."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 0f5b75eb201512604c87f6d75f4234bb685e0879
|
|
exception: "The published 0.1.6 package reports version 0.1.4; `generate ... --confirm --type` defaults to image and `job chain <id> --dry-run` passes NaN before MCP calls; nodes and saved workflows report empty results for `{}` responses; paid `workflow run` and `templates run` ignore surplus positionals; and other mutating commands can ignore trailing flags."
|
|
- name: mobbin-axi
|
|
url: https://github.com/intelligentrascal/mobbin-axi
|
|
author: intelligentrascal
|
|
domain: UI/UX research
|
|
description: "Search real-world UI/UX patterns from production apps via Mobbin - wraps Mobbin's OAuth-gated MCP server as a scriptable, headless CLI with token-efficient TOON output."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 8eda65af7d760efe45907ad3368d3164abe3062e
|
|
exception: "The published 0.1.3 package reports version 0.1.1; search-command --help is rejected; empty-content MCP responses can become successful `0 results`; sections ignores --platform; control commands lack per-command flag sets; and legacy --full and --json flags are no-ops."
|
|
- name: calendly-axi
|
|
url: https://github.com/JarvusInnovations/calendly-axi
|
|
author: Jarvus Innovations
|
|
domain: Scheduling
|
|
description: "The Calendly booking loop from the shell - see what's scheduled, mint single-use booking links, book directly, cancel, and manage event types, availability, and webhooks."
|
|
- name: remarkable-axi
|
|
url: https://github.com/JarvusInnovations/remarkable-axi
|
|
author: Jarvus Innovations
|
|
domain: E-ink tablets
|
|
description: "Manage content on your reMarkable tablet through the reMarkable cloud - browse and organize files, upload PDFs and EPUBs, and send web articles as reflowable EPUBs."
|
|
- name: ado-axi
|
|
url: https://github.com/dtabolich/ado-axi
|
|
author: dtabolich
|
|
domain: Azure DevOps
|
|
description: "Pull requests, branches, repositories, and pipeline runs. Wraps Azure CLI (`az devops` / `az repos`) with agent-ergonomic TOON output."
|
|
- name: ado-axi
|
|
url: https://github.com/jeffreyhaen/ado-axi
|
|
author: jeffreyhaen
|
|
domain: Azure DevOps
|
|
description: "Work items, pull requests, Git refs, pipelines, and raw Azure DevOps REST calls with safe mutations, profiles, and token-efficient TOON output."
|
|
admission:
|
|
status: admitted
|
|
reviewed_revision: 5b997626c17a7798f8aea4ff31613e97886a3cc1
|
|
reviewed_components:
|
|
- src/bin/ado-axi.ts
|
|
- src/lib/args.ts
|
|
- src/lib/format.ts
|
|
- src/commands/home.ts
|
|
- src/commands/workItem.ts
|
|
- src/commands/pr.ts
|
|
- src/commands/pipeline.ts
|
|
- src/commands/ref.ts
|
|
- src/commands/api.ts
|
|
- src/commands/config.ts
|
|
- src/lib/client.ts
|
|
source_observations:
|
|
- "src/commands/api.ts accepts an optional positional HTTP verb, validates path, host, query, body, content type, and raw-response options before calling the shared request client."
|
|
- "src/commands/config.ts lists configured profiles and initializes named profiles with organization, optional project, and az or PAT authentication settings."
|
|
- "src/lib/client.ts constructs encoded Azure DevOps request URLs, resolves credentials, and translates network and HTTP failures into AxiError responses."
|
|
- name: supabase-axi
|
|
url: https://github.com/laizhenyoong/supabase-axi
|
|
author: laizhenyoong
|
|
domain: Supabase
|
|
description: "Inspect schemas, run SQL, and audit RLS, indexes, and logs across Supabase projects. Wraps the Supabase Management API."
|
|
- name: homebrew-axi
|
|
url: https://github.com/mstuart/homebrew-axi
|
|
author: mstuart
|
|
domain: Homebrew
|
|
description: "Inspect Homebrew formulae, casks, and installed packages — versions, dependencies, outdated status, and install stats — with token-efficient TOON output; read-only, never mutates."
|
|
- name: pypi-axi
|
|
url: https://github.com/mstuart/pypi-axi
|
|
author: mstuart
|
|
domain: PyPI
|
|
description: "Inspect PyPI packages, versions, dependencies, and download stats with token-efficient TOON output — read-only, no auth required."
|
|
- name: cargo-axi
|
|
url: https://github.com/AG9898/cargo-axi
|
|
author: AG9898
|
|
domain: Rust / Cargo
|
|
description: "Inspect Rust workspaces and run safe `check` or Clippy validation with compact TOON output and opt-in session context."
|
|
- name: forgejo-axi
|
|
url: https://github.com/escidmore/forgejo-axi
|
|
author: escidmore
|
|
domain: Forgejo
|
|
description: "Pull request lifecycle, issues, and raw API access for self-hosted Forgejo - non-interactive, reconciling mutations, with token-efficient TOON output."
|
|
- name: mastra-axi
|
|
url: https://github.com/taltas/mastra-axi
|
|
author: taltas
|
|
domain: Mastra
|
|
description: "Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output."
|
|
- name: axi-axi
|
|
url: https://github.com/CodyEngel/axi-axi
|
|
author: CodyEngel
|
|
domain: AXI authoring
|
|
description: "Scaffold a compliant AXI, read the 10 principles in token-tuned slices, and run read-only compliance checks against a candidate CLI."
|
|
- name: jira-axi
|
|
url: https://github.com/emilchristensen/atlassian-axi/tree/main/packages/jira-axi
|
|
author: emilchristensen
|
|
domain: Issue tracking
|
|
description: "Create, search, transition, and comment on Jira work items, boards, and sprints through Atlassian's acli with token-efficient TOON output and idempotent mutations."
|
|
- name: confluence-axi
|
|
url: https://github.com/emilchristensen/atlassian-axi/tree/main/packages/confluence-axi
|
|
author: emilchristensen
|
|
domain: Documentation
|
|
description: "Read and write Confluence Cloud pages and spaces directly over the REST API with token-efficient TOON output and OAuth 3LO or API-token auth."
|
|
- name: az-axi
|
|
url: https://github.com/masyanru/az-axi
|
|
author: masyanru
|
|
domain: Azure
|
|
description: "Discover, inspect, query, and safely mutate Azure through token-efficient CLI workflows over every az module."
|
|
- name: mssql-axi
|
|
url: https://github.com/jeffreyhaen/mssql-axi
|
|
author: jeffreyhaen
|
|
domain: Microsoft SQL Server / Azure SQL
|
|
description: "Inspect schemas, sample rows, run capped read-only queries and showplans over the native ODBC driver - mutations double-gated with dry-run by default, TOON output."
|
|
# Admission review (independent source review per VISION.md): inspected
|
|
# Holaxis-ai/superbee at release v0.1.3, commit
|
|
# f4e1c37349627030f8201ff52028f71a9c92570a. Direct source observations:
|
|
# packages/cli/AXI-CONTRACT.md pins the agent-facing interaction contract;
|
|
# src/output.ts renders TOON by default with a compact --json escape hatch;
|
|
# src/errors.ts maps typed failures to stable error codes on the capped
|
|
# 0/1/2/4/5/6 exit taxonomy with structured error envelopes; src/commands/
|
|
# list.ts bounds repeated rows and reports count/shown with a --limit 0
|
|
# escape; src/commands/doc/common.ts gates doc update/delete behind
|
|
# --expected-version compare-and-swap and keeps delete idempotent; and
|
|
# src/commands/home.ts serves a zero-arg live orientation view. Verdict:
|
|
# the source-defined interface and behavior at that revision satisfy the
|
|
# applicable AXI principles; admitted.
|
|
- name: superbee
|
|
url: https://github.com/Holaxis-ai/superbee
|
|
author: Holaxis
|
|
domain: Agent knowledge infrastructure
|
|
description: "Turns what agents know into durable, domain-shaped infrastructure through local OKF bundles with declared schemas, exact queries, conflict-safe writes, and portable Views."
|
|
- name: figma-axi
|
|
url: https://github.com/ardaatahan/figma-axi
|
|
author: ardaatahan
|
|
domain: Design / Figma
|
|
description: "Inspect Figma files, export nodes to PNG/SVG/PDF, and read styles, components, and comments - summarizes huge files instead of dumping raw JSON."
|
|
- name: trello-axi
|
|
url: https://github.com/enzodevs/trello-axi
|
|
author: enzodevs
|
|
domain: Project management
|
|
description: "Create, search, update, move, comment on, and archive Trello cards through the REST API with compact TOON output, complete pagination, idempotent mutations, and non-interactive batch workflows."
|
|
- name: railway-axi
|
|
url: https://github.com/simkimsia/railway-axi
|
|
author: simkimsia
|
|
domain: Railway
|
|
description: "List projects and inspect linked project status, environments, and services. Wraps the Railway CLI with agent-ergonomic TOON output and structured errors."
|
|
- name: netlify-axi
|
|
url: https://github.com/simkimsia/netlify-axi
|
|
author: simkimsia
|
|
domain: Netlify
|
|
description: "List sites and inspect the linked site's status and the logged-in account. Wraps the Netlify CLI with agent-ergonomic TOON output and structured errors."
|
|
# Admission review (independent source review per VISION.md): inspected
|
|
# ardaatahan/vercel-axi at commit
|
|
# 81c88e3582c3018fca8fcc1c4db40c993ece6f18 (no tagged release exists).
|
|
# Direct source observations: src/commands/vercel.ts gates production
|
|
# deploys, promote/rollback, domain add/remove, dns add/remove, and env
|
|
# add/remove behind requireConfirm(), which throws UsageError absent
|
|
# --confirm; src/output/errors.ts maps UsageError to exit 2 and AxiError
|
|
# to exit 1 on the documented 0/1/2 taxonomy; src/vercel/process.ts wraps
|
|
# the official `vercel` binary via spawnSync, converts a missing binary
|
|
# or non-zero exit into a structured AxiError, and detects auth failures
|
|
# to point at `vercel login`/VERCEL_TOKEN; env list redacts value/secret/
|
|
# decryptedValue fields by default (vercel.ts redact()); src/index.ts
|
|
# registers only these gated commands, with no ungated destructive path.
|
|
# Verdict: the source-defined interface and behavior at that revision
|
|
# satisfy the applicable AXI principles; admitted.
|
|
- name: vercel-axi
|
|
url: https://github.com/ardaatahan/vercel-axi
|
|
author: ardaatahan
|
|
domain: Deployment / Vercel
|
|
description: "Deploy and inspect Vercel deployments, projects, domains, DNS, environment variables, and teams through the official Vercel CLI, with explicit confirmation gates for production and infrastructure changes."
|
|
- name: cloudflare-axi
|
|
url: https://github.com/simkimsia/cloudflare-axi
|
|
author: simkimsia
|
|
domain: Cloudflare
|
|
description: "Inspect the current Worker's deployments, Pages projects, KV namespaces, and the logged-in account. Wraps the Cloudflare CLI (wrangler) with agent-ergonomic TOON output and structured errors."
|
|
- name: coolify-axi
|
|
url: https://github.com/radityasurya/coolify-axi
|
|
author: radityasurya
|
|
domain: Coolify
|
|
description: "Apps, databases, services, and deployments on self-hosted or cloud Coolify - name-based addressing, redacted secrets, and TOON output over the official coolify CLI."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 513e9bb2d9addf35135c9fcdd8d7f57ce0de4a43
|
|
reviewed_components:
|
|
- bin/coolify-axi.js
|
|
- src/cli.js
|
|
- src/args.js
|
|
- src/coolify.js
|
|
- src/commands/app.js
|
|
- src/commands/db.js
|
|
source_observations:
|
|
- "src/cli.js passes a `home` handler to runAxiCli that fetches `resource list` and returns counts, a state rollup, and per-resource state, so a no-argument run emits live data rather than the static TOON help in TOP_HELP."
|
|
- "src/args.js parses each subcommand with node:util parseArgs in strict mode and converts ERR_PARSE_ARGS_UNKNOWN_OPTION into an AxiError with code VALIDATION_ERROR whose suggestion names that subcommand's valid flags."
|
|
- "src/coolify.js runs the `coolify` binary through execFile and translates failures into AxiError codes MISSING_DEPENDENCY (ENOENT), AUTH_ERROR, NOT_FOUND, and COOLIFY_ERROR after dropping the wrapped CLI's update banner from stderr; redact()/redactValue() replace secret-named fields and the password segment matched by URL_CREDENTIALS in connection URLs unless --reveal is passed; resolveResource() raises VALIDATION_ERROR listing candidate uuids when a name matches more than one resource."
|
|
- "src/commands/app.js projects `app get` through the DETAIL_FIELDS allow-list, truncates `app logs` to the last LOG_LIMIT (4000) characters with a size hint and a --full escape hatch, and returns `unchanged: true` without calling the wrapped CLI when start or stop targets a resource already in that state."
|
|
exception: "`db get <name|uuid>` in src/commands/db.js returns a normal result payload reading `no database named <name>` for a lookup miss, so the process exits 0; the equivalent miss for applications, services, and servers goes through resolveResource() in src/coolify.js and raises a NOT_FOUND AxiError."
|
|
- name: porkbun-axi
|
|
url: https://github.com/ardaatahan/porkbun-axi
|
|
author: ardaatahan
|
|
domain: Domains / Porkbun
|
|
description: "Manage Porkbun domains, DNS records, SSL certificates, URL forwarding, nameservers, and glue records through the Porkbun API, with compact TOON output and explicit confirmation gates for registrations and destructive updates/deletes."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 394fb206ea58c6d0aaa33a0f24bd6f70f84f206e
|
|
reviewed_components:
|
|
- src/commands/porkbun.ts
|
|
- src/output/errors.ts
|
|
- src/api.ts
|
|
- src/cli/args.ts
|
|
- src/index.ts
|
|
source_observations:
|
|
- "src/commands/porkbun.ts defines gate() which prints the change then throws UsageError unless --confirm is set; dns update/delete, forwarding delete, nameservers set, and glue update/delete call gate(); domains register uses its own --confirm check (not gate()), preflights checkDomain, then submits cost in cents with agreeToTerms only after --confirm; dns update refuses to run without --name."
|
|
- "src/output/errors.ts maps UsageError to exit 2 and AxiError to exit 1 on the documented 0/1/2 taxonomy; src/cli/args.ts throws UsageError on unknown flags with the valid flag set for that command; src/index.ts registers only allCommands from porkbun.ts."
|
|
- "src/api.ts reads PORKBUN_API_KEY and PORKBUN_SECRET_KEY from the environment into X-API-Key / X-Secret-API-Key headers (never the request body) and attaches a fresh Idempotency-Key UUID on idempotent writes; src/commands/porkbun.ts ssl retrieve prints PEM component sizes by default and only emits the certificate material with --json."
|
|
exception: "`dns create`, `forwarding create`, and `glue create` in src/commands/porkbun.ts print a change line then POST the mutation; they do not take --confirm or call gate()."
|
|
- name: wrangler-axi
|
|
url: https://github.com/masculinecache/wrangler-axi
|
|
author: masculinecache
|
|
domain: Cloudflare Wrangler
|
|
description: "Deploy Workers and Pages, manage KV namespaces, D1 databases, R2 buckets, and Worker secrets, and tail live logs with hard bounds - wraps the official Wrangler CLI with predictable TOON lists and structured errors."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 67ff6c45e12f4bb71e42ee8b71d586480c0861be
|
|
reviewed_components:
|
|
- src/cli.ts
|
|
- src/commands/workers.ts
|
|
- src/args.ts
|
|
- src/util.ts
|
|
- src/wrangler.ts
|
|
- src/errors.ts
|
|
- bin/wrangler-axi.ts
|
|
source_observations:
|
|
- "src/cli.ts registers whoami, workers, secrets, kv, d1, r2, and pages areas and returns structured output plus exit codes without calling process.exit; src/commands/workers.ts bounds tail streams by --max-entries or --timeout and renders compact event summaries."
|
|
- "src/args.ts and src/util.ts validate flags and convert unknown areas, subcommands, and flags into AxiError VALIDATION_ERROR responses with corrective suggestions; src/wrangler.ts maps non-zero Wrangler results into structured errors and reports a missing Wrangler dependency explicitly."
|
|
exception: "Mutating commands do not provide an AXI-level --confirm gate; delete and similar operations only forward Wrangler's --force behavior as -f or -y."
|
|
- name: chezmoi-axi
|
|
url: https://github.com/masculinecache/chezmoi-axi
|
|
author: masculinecache
|
|
domain: Dotfiles
|
|
description: "List, diff, add, re-add, apply, verify, and sync chezmoi-managed dotfiles with compact TOON output - template-aware re-add verdicts, preview dry-runs, and idempotent operations."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: ba1c969e1c92471c2fdfc82a6bfad70361fcf2d1
|
|
reviewed_components:
|
|
- chezmoi-axi
|
|
source_observations:
|
|
- "chezmoi-axi implements status, list, diff, add, re-add, apply, verify, sync, and commit as a single shell entrypoint with compact structured output, command-specific help, and exit 0/1/2 handling for success, runtime errors, and usage errors."
|
|
- "re-add uses chezmoi's verbose dry-run to distinguish changed, template-managed, and in-sync files; list caps output at 50 rows with --full, and sync adds branch protection, bounded log rotation, and a preview mode for headless operation."
|
|
exception: "apply and sync mutate the chezmoi state without an AXI-level --confirm gate; --preview provides a dry-run escape hatch."
|
|
- name: mem-axi
|
|
url: https://github.com/masculinecache/axi-memory
|
|
author: masculinecache
|
|
domain: Agent memory
|
|
description: "Durable cross-session agent memory as markdown + YAML frontmatter in a git repo - typed memories, priority-ranked search with L0 abstracts, OS-side dedup, and cross-machine sync."
|
|
admission:
|
|
status: admitted
|
|
reviewed_revision: f6fd3d37079540efb168a189b7a81573b472fb31
|
|
reviewed_components:
|
|
- mem
|
|
- docs/design.md
|
|
- docs/integration.md
|
|
- docs/harnesses.md
|
|
source_observations:
|
|
- "mem stores typed markdown memories with YAML frontmatter under objects/<type>, supports init, add, update, merge, dedup, search, show, list, review, status, sync, and stats, and emits compact structured output with explicit empty states and exit 0/1/2 errors."
|
|
- "mem add refuses credential-like title or body content unless --force is supplied, while dedup is dry-run by default and search/list rank results by priority and freshness with --limit and --min-priority controls; sync bounds pull and push operations with a 30-second timeout."
|
|
- name: fal-axi
|
|
url: https://github.com/ardaatahan/fal-axi
|
|
author: ardaatahan
|
|
domain: Image / Video Generation
|
|
description: "Generate images and videos and poll fal.ai queue status/results through the official @fal-ai/client, with compact TOON output, FAL_KEY env-only auth, and --confirm gates on paid generates."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 532c85a4afcf13cb76b9d7f352fe947182a3ccb8
|
|
reviewed_components:
|
|
- src/commands/fal.ts
|
|
- src/commands/home.ts
|
|
- src/api/fal.ts
|
|
- src/cli/args.ts
|
|
- src/cli/router.ts
|
|
- src/output/errors.ts
|
|
- src/index.ts
|
|
- bin/fal-axi.js
|
|
source_observations:
|
|
- "src/commands/fal.ts registers models list, image generate, video generate, job status, and job result; image/video generate call requireConfirmation() which throws UsageError unless --confirm is set before createApi().submit(), and reject empty/whitespace prompts locally."
|
|
- "src/api/fal.ts reads FAL_KEY from the environment only via requireFalKey(), wraps @fal-ai/client queue.submit/status/result, and validates endpoint IDs (rejecting empty/`.`/`..` segments) plus request IDs before any network call."
|
|
- "src/output/errors.ts maps UsageError to exit 1 and RuntimeError to exit 2; src/cli/args.ts supports a `--` end-of-options terminator; src/index.ts registers only allCommands from fal.ts plus home help."
|
|
exception: "src/output/errors.ts maps UsageError to exit 1 and RuntimeError to exit 2, inverting AXI principle 6 (1=runtime, 2=usage); version probing only accepts `--version` via src/commands/home.ts and prints `fal-axi: <version>`, while `-v`/`-V` are rejected by short-flag handling in src/cli/args.ts instead of printing the bare version and exiting 0 (AXI principle 10)."
|
|
- name: canva-axi
|
|
url: https://github.com/ardaatahan/canva-axi
|
|
author: ardaatahan
|
|
domain: Design / Canva
|
|
description: "List, get, create, export, and autofill Canva designs through the official Canva Connect API, with compact TOON output, CANVA_ACCESS_TOKEN env-only auth, HTTPS-only API bases, and --confirm gates on mutating writes."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 2ed9911e00172c735814d871c139346bd505f37a
|
|
reviewed_components:
|
|
- src/commands/canva.ts
|
|
- src/commands/home.ts
|
|
- src/api/client.ts
|
|
- src/cli/args.ts
|
|
- src/cli/router.ts
|
|
- src/output/errors.ts
|
|
- src/index.ts
|
|
- bin/canva-axi.js
|
|
source_observations:
|
|
- "src/commands/canva.ts registers designs list/get/create/dataset/export-formats, exports create/get/download, and autofills update/get; designs create, exports create, exports download, and autofills update call requireConfirmation() which throws UsageError unless --confirm is set before createApi() network calls."
|
|
- "src/api/client.ts reads CANVA_ACCESS_TOKEN from the environment only via requireAccessToken(), enforces HTTPS-only BASE_CANVA_CONNECT_API_URL (default https://api.canva.com/rest), validates IDs before requests, and rejects non-HTTPS download URLs/redirects."
|
|
- "src/output/errors.ts maps UsageError to exit 1 and RuntimeError to exit 2; src/cli/args.ts supports a `--` end-of-options terminator and rejects short flags; src/index.ts registers only allCommands from canva.ts plus home help."
|
|
exception: "src/output/errors.ts maps UsageError to exit 1 and RuntimeError to exit 2, inverting AXI principle 6 (1=runtime, 2=usage); version probing only accepts `--version` via src/commands/home.ts and prints `canva-axi: <version>`, while `-v`/`-V` are rejected by short-flag handling in src/cli/args.ts instead of printing the bare version and exiting 0 (AXI principle 10)."
|
|
- name: bws-axi
|
|
url: https://github.com/masculinecache/bws-axi
|
|
author: masculinecache
|
|
domain: Bitwarden Secrets Manager
|
|
description: "Agent-ergonomic Bitwarden Secrets Manager CLI - TOON output, values redacted by default, project/key scoped listings."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: e3a122cf5e24790e93279760e3f32a2d552beb0b
|
|
reviewed_components:
|
|
- bin/bws-axi
|
|
- bin/common.mjs
|
|
- skill/SKILL.md
|
|
- package.json
|
|
source_observations:
|
|
- "Read-only Bitwarden Secrets Manager CLI: list projects/secrets, key-scoped listings; values redacted unless `--full` is passed; token goes via BWS_ACCESS_TOKEN env or BWS_TOKEN_FILE (never argv)."
|
|
- "Exit codes mapped correctly (0 success, 2 usage, 1 runtime), output is TOON-ish with values redacted by default."
|
|
- "Reviewed against the published npm tarball @masculinecache/bws-axi@1.0.1 (gitHead e3a122cf…, sha256 e8cbfab67f826a0cf3a6e977bffe248b931072d64fc200d9e255e326a3a4266)."
|
|
exception: "Missing `-v`/`-V` fast path — `--version` probing only via AXI principle 10: the CLI rejects the short hand and prints an error, no bare `bws-axi <version>` probing."
|
|
- name: ha-axi
|
|
url: https://github.com/batamire/ha-axi
|
|
author: batamire
|
|
domain: Home Assistant
|
|
description: "Inspect entities, call services behind safety gates, render templates, and read area/device registries over Home Assistant REST and WebSocket with token-efficient TOON output."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: cad5c4532db19f9d6a2187082f136e2daccfa467
|
|
reviewed_components:
|
|
- src/cli.ts
|
|
- src/ha.ts
|
|
- src/service.ts
|
|
- src/safety.ts
|
|
- src/config.ts
|
|
- src/ws.ts
|
|
- src/bridge.ts
|
|
- src/bin/ha-axi.ts
|
|
source_observations:
|
|
- "src/cli.ts registers ping, entity, service, template, history, logbook, area, device, statistics, and setup through runAxiCli, and its formatError maps AxiError VALIDATION_ERROR/AUTH_MISSING to exit 2 and every other failure to exit 1 while emitting a structured TOON error object with corrective suggestions."
|
|
- "src/service.ts serviceCall refuses the gated domains from src/safety.ts (lock, alarm_control_panel, cover) before any network activity with no override, refuses bulk or non-concrete targets (--all, area, device, entity_id 'all', or no explicit target) unless --i-mean-all is passed, and --dry-run prints the exact request without sending anything."
|
|
- "src/ha.ts sends the token only via the Authorization header, retries GET requests once on 5xx while never retrying POST mutations, applies a 5s connect timeout plus a configurable request timeout, and scrub()s the token out of every error message; src/config.ts resolves flags > HASS_URL/HASS_TOKEN env > config profiles and warns when the profile file is group/world-readable."
|
|
- "src/ws.ts runs a stateless one-shot WebSocket bridge (connect, auth hello, one id-correlated request/response, close, hard deadline) requiring Node >=22's native WebSocket, used by src/bridge.ts for area/device registry and statistics reads; all output is TOON-encoded via @toon-format/toon."
|
|
exception: "`service call` performs mutations without an AXI-level --confirm flag; safety relies on hard-refused gated domains, bulk-target refusals with the explicit --i-mean-all override, and --dry-run, and a profile with `insecure = true` disables TLS verification with a stderr warning."
|
|
- name: calcom-axi
|
|
url: https://github.com/simkimsia/calcom-axi
|
|
author: simkimsia
|
|
domain: Scheduling
|
|
description: "Read your Cal.com agenda, bookings and one booking's attendees and meeting link, event types, availability schedules, free slots for an event type, and the logged-in account. Wraps the Cal.com CLI (calcom) with agent-ergonomic TOON output and structured errors."
|
|
- name: screencast-axi
|
|
url: https://github.com/Valzon/screencast-axi
|
|
author: Valzon
|
|
domain: Screencasts
|
|
description: "Scaffold, rehearse, and record scripted Playwright walkthroughs of any website into mp4, webm, and a poster with a synthetic cursor and burnt-in captions - TOON output, structured errors, and a content-first status view via axi-sdk-js. Requires ffmpeg."
|
|
- name: basecamp-axi
|
|
url: https://github.com/calebl/basecamp-axi
|
|
author: calebl
|
|
domain: Project management
|
|
description: "Projects, to-dos, cards, messages, comments, Campfire chat, people, search, and cross-project assignment reports. Wraps the official `basecamp` CLI with TOON output, pre-computed totals, idempotent mutations, and a `--confirm` gate on trash/archive/restore."
|
|
admission:
|
|
status: admitted
|
|
reviewed_revision: ef8d0ea4b549d3441cbd0286a7d7ae638d58c8a9
|
|
reviewed_components:
|
|
- bin/basecamp-axi.ts
|
|
- src/cli.ts
|
|
- src/basecamp.ts
|
|
- src/errors.ts
|
|
- src/args.ts
|
|
- src/toon.ts
|
|
- src/commands/home.ts
|
|
- src/commands/todo.ts
|
|
- src/commands/report.ts
|
|
- src/commands/recording.ts
|
|
source_observations:
|
|
- "bin/basecamp-axi.ts answers -v/--version through axi-sdk-js/fast-path before importing the command graph; src/cli.ts registers project, todo, todolist, card, message, comment, chat, people, search, report, recording, url, and setup through runAxiCli with per-command help text, and its formatError renders every failure as a TOON `error`/`code`/`help` block with the exit code from exitCodeForError."
|
|
- "src/basecamp.ts shells out to `basecamp <args> --json --no-hints --no-stats`, parses the JSON envelope, and src/errors.ts maps envelope codes and exit codes to AxiError codes (VALIDATION_ERROR, DEPENDENCY_MISSING, DEPENDENCY_OUTDATED, TOOL_DISABLED, NOT_FOUND, AUTH_REQUIRED, FORBIDDEN, RATE_LIMITED, NETWORK_ERROR, AMBIGUOUS, API_ERROR) with a corrective suggestion each; src/args.ts rejects unknown flags and extra positionals as VALIDATION_ERROR."
|
|
- "src/toon.ts encodes lists and details with @toon-format/toon, and countLine prints `count: N of T total` from the totals parsed in src/basecamp.ts; src/commands/home.ts is a content-first dashboard of assigned items with an overdue count and next-step help lines, degrading to a structured unavailable message when the CLI is missing or unauthenticated."
|
|
- "src/commands/todo.ts `done`/`reopen` read current state first and report `already done (no-op)` instead of re-mutating; src/commands/recording.ts gates trash, archive, and restore behind --confirm, printing a `would_change` preview with from/to status and the exact command to apply when the flag is absent, skipping items already in the target status, and emitting an undo hint after applying. No other command deletes or destroys data."
|
|
- name: msgraph-axi
|
|
url: https://github.com/jeffreyhaen/msgraph-axi
|
|
author: jeffreyhaen
|
|
domain: Microsoft 365 / Outlook
|
|
description: "Read, search, draft, and send Outlook mail and manage calendars over the `m365` CLI - read-only by default, with TOON output and mutations behind `--execute`/`--confirm`."
|
|
admission:
|
|
status: admitted
|
|
reviewed_revision: cd31b17b1f2594b5a77f1738ec0f359eb5fb1555
|
|
reviewed_components:
|
|
- src/bin/msgraph-axi.ts
|
|
- src/main.ts
|
|
- src/toon.ts
|
|
- src/flags.ts
|
|
- src/backend.ts
|
|
- src/commands/home.ts
|
|
- src/commands/mail.ts
|
|
- src/commands/calendar.ts
|
|
- src/commands/mailflow.ts
|
|
- src/commands/raw.ts
|
|
source_observations:
|
|
- "src/bin/msgraph-axi.ts answers -v/--version and --help through axi-sdk-js/fast-path before importing the command graph, and src/main.ts registers auth, mail, calendar, user, and raw through runAxiCli with per-command help plus a `home` handler, so a bare run renders the content-first view instead of help text."
|
|
- "src/toon.ts caps cells at CELL_LIMIT = 200 with an ellipsis unless --full is passed, and each list command declares a token-efficient default schema (MAIL_LIST_DEFAULTS = id/from/subject/received, EVENT_DEFAULTS = id/subject/start/end) that `--fields a,b` extends; list results carry a `count` aggregate, a `truncated` marker, and `help[]` next-step lines, while src/commands/home.ts degrades to a signedIn: false object with sign-in help instead of throwing when unauthenticated."
|
|
- "src/flags.ts collects unknown --flags and raises VALIDATION_ERROR naming the subcommand's valid flags (observed at this revision: `mail list --bogus` prints a TOON error/code/help block and exits 2, and an unknown command exits 2); src/backend.ts spawns `m365` with stdin ignored so no agent-driven path can block on a prompt, and the single stdio: inherit call is the explicit `auth login` device-code flow."
|
|
- "Writes are gated consistently: src/commands/mail.ts `mail send`, src/commands/calendar.ts `calendar create`/`update`, and src/commands/mailflow.ts `mail draft` return a preview with `Run with --execute ...` help and never call `m365` without --execute; `mail delete`, `calendar cancel`, and `calendar delete` require an exact-match `--execute --confirm <id>`; src/commands/raw.ts applies the same --execute rule to raw POST/PUT/PATCH/DELETE."
|
|
- name: frontier-axi
|
|
url: https://github.com/oguzalp7/frontier-axi
|
|
author: oguzalp7
|
|
domain: Pre-flight SDLC & Cognitive Bridge
|
|
description: "Stage ambiguous ideas and architectural inquiries until grilling settles them into tasks-axi tickets with token-efficient TOON output."
|
|
admission:
|
|
status: exception
|
|
reviewed_revision: 6e17b3ec0895843c396c9c4c72e22252be99beb4
|
|
reviewed_components:
|
|
- bin/frontier-axi.ts
|
|
- src/cli.ts
|
|
- src/toon.ts
|
|
- src/storage.ts
|
|
- src/commands/promote.ts
|
|
- src/commands/crud.ts
|
|
- src/commands/home.ts
|
|
- src/errors.ts
|
|
- src/args.ts
|
|
- src/index.ts
|
|
- src/version.ts
|
|
source_observations:
|
|
- "bin/frontier-axi.ts answers bare -v/-V/--version through axi-sdk-js/fast-path with leaf src/version.ts before dynamically importing the command graph; src/cli.ts registers add/list/show/update/question/promote/done/cancel/reopen via runAxiCli with content-first home."
|
|
- "src/toon.ts encodes dashboard/list/show with @toon-format/toon; home summary carries active_frontiers/open_questions plus help[]; show accepts --full while truncate() caps body/reason/question text at 80 chars."
|
|
- "src/args.ts requireNoUnknownFlags raises VALIDATION_ERROR on command paths; errors use axi-sdk-js exitCodeForError (VALIDATION_ERROR→2, else→1); add/done/cancel/reopen/promote are idempotent already-no-ops; promote blocks open questions unless --force and spawns tasks-axi via spawnSync argv (not shell)."
|
|
exception: "src/toon.ts truncate()/renderShow truncates body/reason/question text to 80 chars with '...' only — no total-size hint and no --full help line when truncated (AXI principle 3); src/toon.ts renderActiveList empty path emits encode({ active: [] }) without definitive zero-results text (AXI principle 5)."
|