diff --git a/README.md b/README.md index d098acf9..7c0a9e84 100644 --- a/README.md +++ b/README.md @@ -117,96 +117,97 @@ AXIs built and maintained by the community: -| AXI | Author | Domain | What it does | -| ------------------------------------------------------------------------------------------------------ | ------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`jj-axi`](https://github.com/aivv73/jj-axi) | aivv73 | Version control | Inspect and reshape Jujutsu history through deterministic, non-interactive commands with compact TOON output and operation-aware undo. | -| [`npm-axi`](https://github.com/SSBrouhard/npm-axi) | SSBrouhard | npm | Search and inspect npm registry packages, versions, dependencies, README previews, and downloads with token-efficient output. | -| [`sqlite-axi`](https://github.com/SSBrouhard/sqlite-axi) | SSBrouhard | SQLite | Inspect schemas, sample rows, and run capped read-only SQLite queries with token-efficient TOON output. | -| [`slack-axi`](https://github.com/JarvusInnovations/slack-axi) | Jarvus Innovations | Slack | Read, search, sweep, and safely draft Slack messages with token-efficient output. | -| [`gws-axi`](https://github.com/JarvusInnovations/gws-axi) | Jarvus Innovations | Google Workspace | Gmail, Calendar, Docs, Drive, and Slides behind one command, with multi-account write-safety - drafts mail, never sends. | -| [`harvest-axi`](https://github.com/JarvusInnovations/harvest-axi) | Jarvus Innovations | Time tracking | Review, log, and edit Harvest time entries by period - for yourself, your team, a project, or a client. | -| [`specops`](https://github.com/JarvusInnovations/specops) | Jarvus Innovations | Spec-driven dev | Spec-driven development for agents - and a demo of shipping an AXI embedded in a skill, not a standalone npm executable. | -| [`gitsheets-axi`](https://github.com/JarvusInnovations/gitsheets/tree/main/packages/gitsheets-axi) | Jarvus Innovations | Git-backed data | Read and mutate git-backed record sheets over the shell - TOON output, idempotent commits. | -| [`metabase-axi`](https://github.com/JarvusInnovations/metabase-axi) | Jarvus Innovations | Analytics / BI | Query, explore, and export from Metabase over the shell - SQL/MBQL, saved questions, schema introspection, full-data export. | -| [`otter-axi`](https://github.com/JarvusInnovations/otter-axi) | Jarvus Innovations | Meetings | Find and pull Otter.ai meeting transcripts from the shell - wraps Otter.ai's hosted MCP server as a scriptable, headless CLI. | -| [`notion-axi`](https://github.com/maximebrmd/notion-axi) | maximebrmd | Notion | Search, read, create, and update Notion pages and databases over the shell - token-efficient TOON output, PAT or integration auth. | -| [`clickup-axi`](https://github.com/JanSuthacheeva/clickup-axi) | JanSuthacheeva | ClickUp | List your open tasks, view a task with its newest comments inline, and change task status - truncation-aware, TOON-style output. | -| [`databricks-axi`](https://github.com/p33ves/databricks-axi) | p33ves | Databricks | Run Databricks jobs, watch runs, and pull failure logs inline over the official databricks CLI - more domains coming soon. | -| [`aws-axi`](https://github.com/thatdudealso/aws-axi) | thatdudealso | AWS | Discover, plan, provision, deploy, and inspect AWS services for hosting web, backend, database, and AI workloads through safe token-efficient CLI workflows. | -| [`docker-axi`](https://github.com/thatdudealso/docker-axi) | thatdudealso | Docker | Discover, build, run, debug, publish, inspect, and clean up Docker apps through safe token-efficient CLI workflows. | -| [`doctl-axi`](https://github.com/batamire/doctl-axi) | batamire | DigitalOcean | Manage Droplets, Kubernetes, App Platform, databases, networking, and Spaces via doctl with token-efficient TOON output. | -| [`dynamodb-axi`](https://github.com/thatdudealso/dynamodb-axi) | thatdudealso | DynamoDB | Discover, inspect, query, scan, create, update, back up, restore, export, import, and safely operate DynamoDB tables through token-efficient CLI workflows. | -| [`pg-axi`](https://github.com/thatdudealso/pg-axi) | thatdudealso | PostgreSQL | Discover, create, inspect, query, back up, restore, and maintain PostgreSQL databases through safe token-efficient CLI workflows. | -| [`mongodb-axi`](https://github.com/thatdudealso/mongodb-axi) | thatdudealso | MongoDB | Discover, create, inspect, query, export, import, maintain, and diagnose MongoDB databases through safe token-efficient CLI workflows. | -| [`elasticsearch-axi`](https://github.com/thatdudealso/elasticsearch-axi) | thatdudealso | Elasticsearch | Discover, inspect, query, index, map, snapshot, restore, diagnose, and operate Elasticsearch clusters through safe token-efficient CLI workflows. | -| [`kubernetes-axi`](https://github.com/thatdudealso/kubernetes-axi) | thatdudealso | Kubernetes | Discover, inspect, deploy, debug, scale, roll out, expose, and clean up Kubernetes workloads through safe token-efficient CLI workflows. | -| [`redis-axi`](https://github.com/thatdudealso/redis-axi) | thatdudealso | Redis | Discover, inspect, query, export, import, maintain, and diagnose Redis databases through safe token-efficient CLI workflows. | -| [`celery-axi`](https://github.com/thatdudealso/celery-axi) | thatdudealso | Celery | Discover, inspect, run, debug, monitor, schedule, control, and safely operate Celery task queues through token-efficient CLI workflows. | -| [`cyber-mux`](https://github.com/cyberuni/cyber-mux) | unional | Terminal multiplexers | Open, send, read, focus, and close terminal panes across tmux, herdr, and WezTerm through one detection-driven contract with token-efficient output. | -| [`oracle-axi`](https://github.com/thatdudealso/oracle-axi) | thatdudealso | Oracle Database | Discover, create, inspect, query, export, import, maintain, and diagnose Oracle databases through safe token-efficient CLI workflows. | -| [`glab-axi`](https://github.com/karotkriss/glab-axi) | karotkriss | GitLab | Issues, merge requests, CI/CD pipelines, variables and secrets, releases, and raw API access. Wraps the official glab CLI with agent-ergonomic TOON output. | -| [`reactive-axi`](https://github.com/adeeshsharma/reactive-axi) | adeeshsharma | UI review | 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. | -| [`obsidian-axi`](https://github.com/AndersHoffmann/obsidian-axi) | AndersHoffmann | Obsidian | Read, search, create, update, organize, and link Obsidian notes from the filesystem - compact TOON output, atomic writes, no plugin or server. | -| [`comfy-cloud-axi`](https://github.com/intelligentrascal/comfy-cloud-axi) | intelligentrascal | AI generation | 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. | -| [`mobbin-axi`](https://github.com/intelligentrascal/mobbin-axi) | intelligentrascal | UI/UX research | 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. | -| [`calendly-axi`](https://github.com/JarvusInnovations/calendly-axi) | Jarvus Innovations | Scheduling | 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. | -| [`remarkable-axi`](https://github.com/JarvusInnovations/remarkable-axi) | Jarvus Innovations | E-ink tablets | 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. | -| [`ado-axi`](https://github.com/dtabolich/ado-axi) | dtabolich | Azure DevOps | Pull requests, branches, repositories, and pipeline runs. Wraps Azure CLI (`az devops` / `az repos`) with agent-ergonomic TOON output. | -| [`ado-axi`](https://github.com/jeffreyhaen/ado-axi) | jeffreyhaen | Azure DevOps | Work items, pull requests, Git refs, pipelines, and raw Azure DevOps REST calls with safe mutations, profiles, and token-efficient TOON output. | -| [`supabase-axi`](https://github.com/laizhenyoong/supabase-axi) | laizhenyoong | Supabase | Inspect schemas, run SQL, and audit RLS, indexes, and logs across Supabase projects. Wraps the Supabase Management API. | -| [`homebrew-axi`](https://github.com/mstuart/homebrew-axi) | mstuart | Homebrew | Inspect Homebrew formulae, casks, and installed packages — versions, dependencies, outdated status, and install stats — with token-efficient TOON output; read-only, never mutates. | -| [`pypi-axi`](https://github.com/mstuart/pypi-axi) | mstuart | PyPI | Inspect PyPI packages, versions, dependencies, and download stats with token-efficient TOON output — read-only, no auth required. | -| [`cargo-axi`](https://github.com/AG9898/cargo-axi) | AG9898 | Rust / Cargo | Inspect Rust workspaces and run safe `check` or Clippy validation with compact TOON output and opt-in session context. | -| [`forgejo-axi`](https://github.com/escidmore/forgejo-axi) | escidmore | Forgejo | Pull request lifecycle, issues, and raw API access for self-hosted Forgejo - non-interactive, reconciling mutations, with token-efficient TOON output. | -| [`mastra-axi`](https://github.com/taltas/mastra-axi) | taltas | Mastra | Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output. | -| [`axi-axi`](https://github.com/CodyEngel/axi-axi) | CodyEngel | AXI authoring | Scaffold a compliant AXI, read the 10 principles in token-tuned slices, and run read-only compliance checks against a candidate CLI. | -| [`jira-axi`](https://github.com/emilchristensen/atlassian-axi/tree/main/packages/jira-axi) | emilchristensen | Issue tracking | Create, search, transition, and comment on Jira work items, boards, and sprints through Atlassian's acli with token-efficient TOON output and idempotent mutations. | -| [`confluence-axi`](https://github.com/emilchristensen/atlassian-axi/tree/main/packages/confluence-axi) | emilchristensen | Documentation | 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. | -| [`az-axi`](https://github.com/masyanru/az-axi) | masyanru | Azure | Discover, inspect, query, and safely mutate Azure through token-efficient CLI workflows over every az module. | -| [`mssql-axi`](https://github.com/jeffreyhaen/mssql-axi) | jeffreyhaen | Microsoft SQL Server / Azure SQL | 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. | -| [`superbee`](https://github.com/Holaxis-ai/superbee) | Holaxis | Agent knowledge infrastructure | Turns what agents know into durable, domain-shaped infrastructure through local OKF bundles with declared schemas, exact queries, conflict-safe writes, and portable Views. | -| [`figma-axi`](https://github.com/ardaatahan/figma-axi) | ardaatahan | Design / Figma | Inspect Figma files, export nodes to PNG/SVG/PDF, and read styles, components, and comments - summarizes huge files instead of dumping raw JSON. | -| [`trello-axi`](https://github.com/enzodevs/trello-axi) | enzodevs | Project management | 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. | -| [`railway-axi`](https://github.com/simkimsia/railway-axi) | simkimsia | Railway | List projects and inspect linked project status, environments, and services. Wraps the Railway CLI with agent-ergonomic TOON output and structured errors. | -| [`netlify-axi`](https://github.com/simkimsia/netlify-axi) | simkimsia | Netlify | 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. | -| [`vercel-axi`](https://github.com/ardaatahan/vercel-axi) | ardaatahan | Deployment / Vercel | 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. | -| [`cloudflare-axi`](https://github.com/simkimsia/cloudflare-axi) | simkimsia | Cloudflare | 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. | -| [`coolify-axi`](https://github.com/radityasurya/coolify-axi) | radityasurya | Coolify | Apps, databases, services, and deployments on self-hosted or cloud Coolify - name-based addressing, redacted secrets, and TOON output over the official coolify CLI. | -| [`porkbun-axi`](https://github.com/ardaatahan/porkbun-axi) | ardaatahan | Domains / Porkbun | 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. | -| [`wrangler-axi`](https://github.com/masculinecache/wrangler-axi) | masculinecache | Cloudflare Wrangler | 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. | -| [`chezmoi-axi`](https://github.com/masculinecache/chezmoi-axi) | masculinecache | Dotfiles | 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. | -| [`mem-axi`](https://github.com/masculinecache/axi-memory) | masculinecache | Agent memory | 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. | -| [`fal-axi`](https://github.com/ardaatahan/fal-axi) | ardaatahan | Image / Video Generation | 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. | -| [`canva-axi`](https://github.com/ardaatahan/canva-axi) | ardaatahan | Design / Canva | 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. | -| [`bws-axi`](https://github.com/masculinecache/bws-axi) | masculinecache | Bitwarden Secrets Manager | Agent-ergonomic Bitwarden Secrets Manager CLI - TOON output, values redacted by default, project/key scoped listings. | -| [`ha-axi`](https://github.com/batamire/ha-axi) | batamire | Home Assistant | 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. | -| [`calcom-axi`](https://github.com/simkimsia/calcom-axi) | simkimsia | Scheduling | 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. | -| [`screencast-axi`](https://github.com/Valzon/screencast-axi) | Valzon | Screencasts | 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. | -| [`basecamp-axi`](https://github.com/calebl/basecamp-axi) | calebl | Project management | 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. | -| [`msgraph-axi`](https://github.com/jeffreyhaen/msgraph-axi) | jeffreyhaen | Microsoft 365 / Outlook | 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`. | -| [`frontier-axi`](https://github.com/oguzalp7/frontier-axi) | oguzalp7 | Pre-flight SDLC & Cognitive Bridge | Stage ambiguous ideas and architectural inquiries until grilling settles them into tasks-axi tickets with token-efficient TOON output. | -| [`design-system-axi`](https://github.com/isamrish/design-system-axi) | isamrish | Design systems | Look up components, import paths, props, and examples from a design system's Storybook manifest and metadata, with a deterministic `find` that marks weak matches - Primer React first. | -| [`shopify-axi`](https://github.com/elliottkan/shopify-axi) | elliottkan | Shopify | Search shopify.dev and validate generated GraphQL, Liquid themes, and Polaris components against the real schemas - wraps Shopify's Dev MCP server and exits non-zero on hallucinated fields. | -| [`asana-axi`](https://github.com/elliottkan/asana-axi) | elliottkan | Project management | Create, search, update, and comment on Asana tasks, projects, and portfolios through Asana's official V2 MCP server as a scriptable headless CLI, with OAuth login, TOON output, and structured errors. | -| [`clockify-axi`](https://github.com/elliottkan/clockify-axi) | elliottkan | Time tracking | Wraps Clockify's full REST API (not just its 13-tool MCP server) with a cached workspace/user identity, TOON output, and AXI exit codes for timers, time entries, projects, tasks, clients, tags, and reports. | -| [`jev-axi`](https://github.com/shiftynick/jev-axi) | shiftynick | AI judgments | Offload snap judgments to TypeSafe's Jev model - pick, rate, check, rank, filter, semantic grep, diff review, log triage, and prompt-injection screening over files or stdin, with calibrated confidence bands and local usage/cost stats. | -| [`linear-sdk-axi`](https://github.com/shiftynick/linear-sdk-axi) | shiftynick | Linear | Issues, comments, relations, projects, project updates, cycles, labels, and teams over the official `@linear/sdk` - no MCP server, with dry-run, verified writes, bounded pagination, and TOON or JSON output. | -| [`asana-axi`](https://github.com/brycehamrick/asana-axi) | brycehamrick | Project management | Create, search, update, and complete Asana tasks, projects, sections, tags, workspaces, comments, and attachments over the Asana REST API - read-first defaults, idempotent mutations, and token-efficient TOON output. | -| [`brevo-axi`](https://github.com/brycehamrick/brevo-axi) | brycehamrick | Email marketing / Messaging | Send and audit transactional email and SMS, manage campaigns, contacts, lists, attributes, CRM deals, companies, tasks, notes, senders, domains, and webhooks over the Brevo v3 REST API - sandbox-validated sends and `--confirm`-gated mutations with token-efficient TOON output. | -| [`firecrawl-axi`](https://github.com/brycehamrick/firecrawl-axi) | brycehamrick | Web data / Research | Scrape, map, and crawl sites, search the web and research indexes, parse documents, run async research agents, and manage change monitors over the hosted Firecrawl MCP server - token-efficient TOON output. | -| [`n8n-axi`](https://github.com/brycehamrick/n8n-axi) | brycehamrick | Workflow automation | Search, inspect, run, test, publish, and archive n8n workflows; triage executions; and manage projects, folders, tags, data tables, and credentials over n8n's instance-level MCP server - validate-then-create authoring with `--confirm`-gated mutations. | -| [`open-design-axi`](https://github.com/brycehamrick/open-design-axi) | brycehamrick | Design | Browse and operate OpenDesign projects, files, artifacts, and generation runs from the shell, with offline reads from the local data directory when the daemon is down - `--confirm`-gated project create/delete and generation runs. | -| [`playwright-axi`](https://github.com/brycehamrick/playwright-axi) | brycehamrick | Browser automation | Navigate, click, fill, and extract with combined operations, inline filtered snapshots, and TOON output. Wraps the `playwright` npm package's agent CLI. | -| [`tally-axi`](https://github.com/brycehamrick/tally-axi) | brycehamrick | Forms / Surveys | Read Tally forms and submissions field-by-field and manage FORM_RESPONSE webhooks over the public Tally REST API - pre-computed counts, truncation with a `--full` escape hatch, and token-efficient TOON output. | -| [`walter-axi`](https://github.com/brycehamrick/walter-axi) | brycehamrick | AI content editing | Detect AI-generated patterns, humanize drafts with locked keywords, and batch QA content through the WalterWrites MCP server - `--confirm` gates on credit-consuming writes. | -| [`wordpress-axi`](https://github.com/brycehamrick/wordpress-axi) | brycehamrick | CMS / WordPress | Publish and moderate posts, pages, media, terms, comments, users, and settings, and inspect plugins and themes over the core WordPress REST API - new content defaults to draft, publication and deletion are `--confirm`-gated. | -| [`mesheryctl-axi`](https://github.com/meshery-extensions/mesheryctl-axi) | Meshery Authors | Meshery / cloud native | Agent-ergonomic wrapper around mesheryctl - token-efficient TOON list/view reporting, non-interactive execution, structured errors, and help[] next-step suggestions. | -| [`plane-axi`](https://github.com/radityasurya/plane-axi) | radityasurya | Project tracking | Manage Plane projects, issues, states, priorities, and comments with sequence-ID addressing (`#110`), name-based project/state resolution, and idempotent close - for Plane Cloud or self-hosted Plane. | -| [`gerrit-axi`](https://github.com/slnkjthien/gerrit-axi) | slnkjthien | Code review / Gerrit | Read Gerrit review state as records - a sectioned dashboard, change readiness, and inline comments with bot/human filtering - then publish a branch as a stack or squashed change, post a change message, and submit it; voting is impossible by design. | -| [`bun-axi`](https://github.com/mlegls/bun-axi) | mlegls | Bun | Run Bun tests and package.json scripts and get counts, failure locations, load errors, and tsc/oxlint diagnostics instead of raw logs - plus dependency and npm registry lookups. | -| [`router-axi`](https://github.com/Azd325/router-axi) | Azd325 | Router / TR-064 | Agent-ergonomic router inspection CLI - read-only TR-064 inspection (device, WAN, traffic, calls, devices, leases, Wi-Fi, guest Wi-Fi, port forwards) plus confirmed mutations (`wifi enable\|disable`, `reboot`) and configuration backup over documented FRITZ!Box TR-064 interfaces. | -| [`google-marketing-axi`](https://github.com/elliottkan/google-marketing-axi) | elliottkan | Google Analytics / Tag Manager | Run GA4 reports, realtime views, and dimension/metric search, and inspect or edit Google Tag Manager tags, triggers, and variables with field-level diffs, --dry-run, and fingerprinted updates - version snapshots stop short of publishing by design. | -| [`hey-axi`](https://github.com/TangentialSolutions/hey-axi) | TangentialSolutions | HEY email | HEY email, calendars, todos, habits, journal, and time tracking over Basecamp's official `hey` CLI - live home view, `setup hooks` and `setup scope`, minimal TOON fields with counts and `--full`, and send safety: compose and reply save drafts unless `--allow-send`. | +| AXI | Author | Domain | What it does | +| ------------------------------------------------------------------------------------------------------ | ------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [`jj-axi`](https://github.com/aivv73/jj-axi) | aivv73 | Version control | Inspect and reshape Jujutsu history through deterministic, non-interactive commands with compact TOON output and operation-aware undo. | +| [`npm-axi`](https://github.com/SSBrouhard/npm-axi) | SSBrouhard | npm | Search and inspect npm registry packages, versions, dependencies, README previews, and downloads with token-efficient output. | +| [`sqlite-axi`](https://github.com/SSBrouhard/sqlite-axi) | SSBrouhard | SQLite | Inspect schemas, sample rows, and run capped read-only SQLite queries with token-efficient TOON output. | +| [`slack-axi`](https://github.com/JarvusInnovations/slack-axi) | Jarvus Innovations | Slack | Read, search, sweep, and safely draft Slack messages with token-efficient output. | +| [`gws-axi`](https://github.com/JarvusInnovations/gws-axi) | Jarvus Innovations | Google Workspace | Gmail, Calendar, Docs, Drive, and Slides behind one command, with multi-account write-safety - drafts mail, never sends. | +| [`harvest-axi`](https://github.com/JarvusInnovations/harvest-axi) | Jarvus Innovations | Time tracking | Review, log, and edit Harvest time entries by period - for yourself, your team, a project, or a client. | +| [`specops`](https://github.com/JarvusInnovations/specops) | Jarvus Innovations | Spec-driven dev | Spec-driven development for agents - and a demo of shipping an AXI embedded in a skill, not a standalone npm executable. | +| [`gitsheets-axi`](https://github.com/JarvusInnovations/gitsheets/tree/main/packages/gitsheets-axi) | Jarvus Innovations | Git-backed data | Read and mutate git-backed record sheets over the shell - TOON output, idempotent commits. | +| [`metabase-axi`](https://github.com/JarvusInnovations/metabase-axi) | Jarvus Innovations | Analytics / BI | Query, explore, and export from Metabase over the shell - SQL/MBQL, saved questions, schema introspection, full-data export. | +| [`otter-axi`](https://github.com/JarvusInnovations/otter-axi) | Jarvus Innovations | Meetings | Find and pull Otter.ai meeting transcripts from the shell - wraps Otter.ai's hosted MCP server as a scriptable, headless CLI. | +| [`notion-axi`](https://github.com/maximebrmd/notion-axi) | maximebrmd | Notion | Search, read, create, and update Notion pages and databases over the shell - token-efficient TOON output, PAT or integration auth. | +| [`clickup-axi`](https://github.com/JanSuthacheeva/clickup-axi) | JanSuthacheeva | ClickUp | List your open tasks, view a task with its newest comments inline, and change task status - truncation-aware, TOON-style output. | +| [`databricks-axi`](https://github.com/p33ves/databricks-axi) | p33ves | Databricks | Run Databricks jobs, watch runs, and pull failure logs inline over the official databricks CLI - more domains coming soon. | +| [`aws-axi`](https://github.com/thatdudealso/aws-axi) | thatdudealso | AWS | Discover, plan, provision, deploy, and inspect AWS services for hosting web, backend, database, and AI workloads through safe token-efficient CLI workflows. | +| [`docker-axi`](https://github.com/thatdudealso/docker-axi) | thatdudealso | Docker | Discover, build, run, debug, publish, inspect, and clean up Docker apps through safe token-efficient CLI workflows. | +| [`doctl-axi`](https://github.com/batamire/doctl-axi) | batamire | DigitalOcean | Manage Droplets, Kubernetes, App Platform, databases, networking, and Spaces via doctl with token-efficient TOON output. | +| [`dynamodb-axi`](https://github.com/thatdudealso/dynamodb-axi) | thatdudealso | DynamoDB | Discover, inspect, query, scan, create, update, back up, restore, export, import, and safely operate DynamoDB tables through token-efficient CLI workflows. | +| [`pg-axi`](https://github.com/thatdudealso/pg-axi) | thatdudealso | PostgreSQL | Discover, create, inspect, query, back up, restore, and maintain PostgreSQL databases through safe token-efficient CLI workflows. | +| [`mongodb-axi`](https://github.com/thatdudealso/mongodb-axi) | thatdudealso | MongoDB | Discover, create, inspect, query, export, import, maintain, and diagnose MongoDB databases through safe token-efficient CLI workflows. | +| [`elasticsearch-axi`](https://github.com/thatdudealso/elasticsearch-axi) | thatdudealso | Elasticsearch | Discover, inspect, query, index, map, snapshot, restore, diagnose, and operate Elasticsearch clusters through safe token-efficient CLI workflows. | +| [`kubernetes-axi`](https://github.com/thatdudealso/kubernetes-axi) | thatdudealso | Kubernetes | Discover, inspect, deploy, debug, scale, roll out, expose, and clean up Kubernetes workloads through safe token-efficient CLI workflows. | +| [`redis-axi`](https://github.com/thatdudealso/redis-axi) | thatdudealso | Redis | Discover, inspect, query, export, import, maintain, and diagnose Redis databases through safe token-efficient CLI workflows. | +| [`celery-axi`](https://github.com/thatdudealso/celery-axi) | thatdudealso | Celery | Discover, inspect, run, debug, monitor, schedule, control, and safely operate Celery task queues through token-efficient CLI workflows. | +| [`cyber-mux`](https://github.com/cyberuni/cyber-mux) | unional | Terminal multiplexers | Open, send, read, focus, and close terminal panes across tmux, herdr, and WezTerm through one detection-driven contract with token-efficient output. | +| [`oracle-axi`](https://github.com/thatdudealso/oracle-axi) | thatdudealso | Oracle Database | Discover, create, inspect, query, export, import, maintain, and diagnose Oracle databases through safe token-efficient CLI workflows. | +| [`glab-axi`](https://github.com/karotkriss/glab-axi) | karotkriss | GitLab | Issues, merge requests, CI/CD pipelines, variables and secrets, releases, and raw API access. Wraps the official glab CLI with agent-ergonomic TOON output. | +| [`reactive-axi`](https://github.com/adeeshsharma/reactive-axi) | adeeshsharma | UI review | 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. | +| [`obsidian-axi`](https://github.com/AndersHoffmann/obsidian-axi) | AndersHoffmann | Obsidian | Read, search, create, update, organize, and link Obsidian notes from the filesystem - compact TOON output, atomic writes, no plugin or server. | +| [`comfy-cloud-axi`](https://github.com/intelligentrascal/comfy-cloud-axi) | intelligentrascal | AI generation | 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. | +| [`mobbin-axi`](https://github.com/intelligentrascal/mobbin-axi) | intelligentrascal | UI/UX research | 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. | +| [`calendly-axi`](https://github.com/JarvusInnovations/calendly-axi) | Jarvus Innovations | Scheduling | 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. | +| [`remarkable-axi`](https://github.com/JarvusInnovations/remarkable-axi) | Jarvus Innovations | E-ink tablets | 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. | +| [`ado-axi`](https://github.com/dtabolich/ado-axi) | dtabolich | Azure DevOps | Pull requests, branches, repositories, and pipeline runs. Wraps Azure CLI (`az devops` / `az repos`) with agent-ergonomic TOON output. | +| [`ado-axi`](https://github.com/jeffreyhaen/ado-axi) | jeffreyhaen | Azure DevOps | Work items, pull requests, Git refs, pipelines, and raw Azure DevOps REST calls with safe mutations, profiles, and token-efficient TOON output. | +| [`supabase-axi`](https://github.com/laizhenyoong/supabase-axi) | laizhenyoong | Supabase | Inspect schemas, run SQL, and audit RLS, indexes, and logs across Supabase projects. Wraps the Supabase Management API. | +| [`homebrew-axi`](https://github.com/mstuart/homebrew-axi) | mstuart | Homebrew | Inspect Homebrew formulae, casks, and installed packages — versions, dependencies, outdated status, and install stats — with token-efficient TOON output; read-only, never mutates. | +| [`pypi-axi`](https://github.com/mstuart/pypi-axi) | mstuart | PyPI | Inspect PyPI packages, versions, dependencies, and download stats with token-efficient TOON output — read-only, no auth required. | +| [`cargo-axi`](https://github.com/AG9898/cargo-axi) | AG9898 | Rust / Cargo | Inspect Rust workspaces and run safe `check` or Clippy validation with compact TOON output and opt-in session context. | +| [`forgejo-axi`](https://github.com/escidmore/forgejo-axi) | escidmore | Forgejo | Pull request lifecycle, issues, and raw API access for self-hosted Forgejo - non-interactive, reconciling mutations, with token-efficient TOON output. | +| [`mastra-axi`](https://github.com/taltas/mastra-axi) | taltas | Mastra | Discover and run a Mastra app's agents, tools, and workflows through agent-native shell commands with compact TOON output. | +| [`axi-axi`](https://github.com/CodyEngel/axi-axi) | CodyEngel | AXI authoring | Scaffold a compliant AXI, read the 10 principles in token-tuned slices, and run read-only compliance checks against a candidate CLI. | +| [`jira-axi`](https://github.com/emilchristensen/atlassian-axi/tree/main/packages/jira-axi) | emilchristensen | Issue tracking | Create, search, transition, and comment on Jira work items, boards, and sprints through Atlassian's acli with token-efficient TOON output and idempotent mutations. | +| [`confluence-axi`](https://github.com/emilchristensen/atlassian-axi/tree/main/packages/confluence-axi) | emilchristensen | Documentation | 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. | +| [`az-axi`](https://github.com/masyanru/az-axi) | masyanru | Azure | Discover, inspect, query, and safely mutate Azure through token-efficient CLI workflows over every az module. | +| [`mssql-axi`](https://github.com/jeffreyhaen/mssql-axi) | jeffreyhaen | Microsoft SQL Server / Azure SQL | 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. | +| [`superbee`](https://github.com/Holaxis-ai/superbee) | Holaxis | Agent knowledge infrastructure | Turns what agents know into durable, domain-shaped infrastructure through local OKF bundles with declared schemas, exact queries, conflict-safe writes, and portable Views. | +| [`figma-axi`](https://github.com/ardaatahan/figma-axi) | ardaatahan | Design / Figma | Inspect Figma files, export nodes to PNG/SVG/PDF, and read styles, components, and comments - summarizes huge files instead of dumping raw JSON. | +| [`trello-axi`](https://github.com/enzodevs/trello-axi) | enzodevs | Project management | 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. | +| [`railway-axi`](https://github.com/simkimsia/railway-axi) | simkimsia | Railway | List projects and inspect linked project status, environments, and services. Wraps the Railway CLI with agent-ergonomic TOON output and structured errors. | +| [`netlify-axi`](https://github.com/simkimsia/netlify-axi) | simkimsia | Netlify | 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. | +| [`vercel-axi`](https://github.com/ardaatahan/vercel-axi) | ardaatahan | Deployment / Vercel | 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. | +| [`cloudflare-axi`](https://github.com/simkimsia/cloudflare-axi) | simkimsia | Cloudflare | 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. | +| [`coolify-axi`](https://github.com/radityasurya/coolify-axi) | radityasurya | Coolify | Apps, databases, services, and deployments on self-hosted or cloud Coolify - name-based addressing, redacted secrets, and TOON output over the official coolify CLI. | +| [`porkbun-axi`](https://github.com/ardaatahan/porkbun-axi) | ardaatahan | Domains / Porkbun | 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. | +| [`wrangler-axi`](https://github.com/masculinecache/wrangler-axi) | masculinecache | Cloudflare Wrangler | 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. | +| [`chezmoi-axi`](https://github.com/masculinecache/chezmoi-axi) | masculinecache | Dotfiles | 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. | +| [`mem-axi`](https://github.com/masculinecache/axi-memory) | masculinecache | Agent memory | 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. | +| [`fal-axi`](https://github.com/ardaatahan/fal-axi) | ardaatahan | Image / Video Generation | 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. | +| [`canva-axi`](https://github.com/ardaatahan/canva-axi) | ardaatahan | Design / Canva | 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. | +| [`bws-axi`](https://github.com/masculinecache/bws-axi) | masculinecache | Bitwarden Secrets Manager | Agent-ergonomic Bitwarden Secrets Manager CLI - TOON output, values redacted by default, project/key scoped listings. | +| [`ha-axi`](https://github.com/batamire/ha-axi) | batamire | Home Assistant | 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. | +| [`calcom-axi`](https://github.com/simkimsia/calcom-axi) | simkimsia | Scheduling | 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. | +| [`screencast-axi`](https://github.com/Valzon/screencast-axi) | Valzon | Screencasts | 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. | +| [`basecamp-axi`](https://github.com/calebl/basecamp-axi) | calebl | Project management | 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. | +| [`msgraph-axi`](https://github.com/jeffreyhaen/msgraph-axi) | jeffreyhaen | Microsoft 365 / Outlook | 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`. | +| [`frontier-axi`](https://github.com/oguzalp7/frontier-axi) | oguzalp7 | Pre-flight SDLC & Cognitive Bridge | Stage ambiguous ideas and architectural inquiries until grilling settles them into tasks-axi tickets with token-efficient TOON output. | +| [`design-system-axi`](https://github.com/isamrish/design-system-axi) | isamrish | Design systems | Look up components, import paths, props, and examples from a design system's Storybook manifest and metadata, with a deterministic `find` that marks weak matches - Primer React first. | +| [`shopify-axi`](https://github.com/elliottkan/shopify-axi) | elliottkan | Shopify | Search shopify.dev and validate generated GraphQL, Liquid themes, and Polaris components against the real schemas - wraps Shopify's Dev MCP server and exits non-zero on hallucinated fields. | +| [`asana-axi`](https://github.com/elliottkan/asana-axi) | elliottkan | Project management | Create, search, update, and comment on Asana tasks, projects, and portfolios through Asana's official V2 MCP server as a scriptable headless CLI, with OAuth login, TOON output, and structured errors. | +| [`clockify-axi`](https://github.com/elliottkan/clockify-axi) | elliottkan | Time tracking | Wraps Clockify's full REST API (not just its 13-tool MCP server) with a cached workspace/user identity, TOON output, and AXI exit codes for timers, time entries, projects, tasks, clients, tags, and reports. | +| [`jev-axi`](https://github.com/shiftynick/jev-axi) | shiftynick | AI judgments | Offload snap judgments to TypeSafe's Jev model - pick, rate, check, rank, filter, semantic grep, diff review, log triage, and prompt-injection screening over files or stdin, with calibrated confidence bands and local usage/cost stats. | +| [`linear-sdk-axi`](https://github.com/shiftynick/linear-sdk-axi) | shiftynick | Linear | Issues, comments, relations, projects, project updates, cycles, labels, and teams over the official `@linear/sdk` - no MCP server, with dry-run, verified writes, bounded pagination, and TOON or JSON output. | +| [`asana-axi`](https://github.com/brycehamrick/asana-axi) | brycehamrick | Project management | Create, search, update, and complete Asana tasks, projects, sections, tags, workspaces, comments, and attachments over the Asana REST API - read-first defaults, idempotent mutations, and token-efficient TOON output. | +| [`brevo-axi`](https://github.com/brycehamrick/brevo-axi) | brycehamrick | Email marketing / Messaging | Send and audit transactional email and SMS, manage campaigns, contacts, lists, attributes, CRM deals, companies, tasks, notes, senders, domains, and webhooks over the Brevo v3 REST API - sandbox-validated sends and `--confirm`-gated mutations with token-efficient TOON output. | +| [`firecrawl-axi`](https://github.com/brycehamrick/firecrawl-axi) | brycehamrick | Web data / Research | Scrape, map, and crawl sites, search the web and research indexes, parse documents, run async research agents, and manage change monitors over the hosted Firecrawl MCP server - token-efficient TOON output. | +| [`n8n-axi`](https://github.com/brycehamrick/n8n-axi) | brycehamrick | Workflow automation | Search, inspect, run, test, publish, and archive n8n workflows; triage executions; and manage projects, folders, tags, data tables, and credentials over n8n's instance-level MCP server - validate-then-create authoring with `--confirm`-gated mutations. | +| [`open-design-axi`](https://github.com/brycehamrick/open-design-axi) | brycehamrick | Design | Browse and operate OpenDesign projects, files, artifacts, and generation runs from the shell, with offline reads from the local data directory when the daemon is down - `--confirm`-gated project create/delete and generation runs. | +| [`playwright-axi`](https://github.com/brycehamrick/playwright-axi) | brycehamrick | Browser automation | Navigate, click, fill, and extract with combined operations, inline filtered snapshots, and TOON output. Wraps the `playwright` npm package's agent CLI. | +| [`tally-axi`](https://github.com/brycehamrick/tally-axi) | brycehamrick | Forms / Surveys | Read Tally forms and submissions field-by-field and manage FORM_RESPONSE webhooks over the public Tally REST API - pre-computed counts, truncation with a `--full` escape hatch, and token-efficient TOON output. | +| [`walter-axi`](https://github.com/brycehamrick/walter-axi) | brycehamrick | AI content editing | Detect AI-generated patterns, humanize drafts with locked keywords, and batch QA content through the WalterWrites MCP server - `--confirm` gates on credit-consuming writes. | +| [`wordpress-axi`](https://github.com/brycehamrick/wordpress-axi) | brycehamrick | CMS / WordPress | Publish and moderate posts, pages, media, terms, comments, users, and settings, and inspect plugins and themes over the core WordPress REST API - new content defaults to draft, publication and deletion are `--confirm`-gated. | +| [`mesheryctl-axi`](https://github.com/meshery-extensions/mesheryctl-axi) | Meshery Authors | Meshery / cloud native | Agent-ergonomic wrapper around mesheryctl - token-efficient TOON list/view reporting, non-interactive execution, structured errors, and help[] next-step suggestions. | +| [`plane-axi`](https://github.com/radityasurya/plane-axi) | radityasurya | Project tracking | Manage Plane projects, issues, states, priorities, and comments with sequence-ID addressing (`#110`), name-based project/state resolution, and idempotent close - for Plane Cloud or self-hosted Plane. | +| [`gerrit-axi`](https://github.com/slnkjthien/gerrit-axi) | slnkjthien | Code review / Gerrit | Read Gerrit review state as records - a sectioned dashboard, change readiness, and inline comments with bot/human filtering - then publish a branch as a stack or squashed change, post a change message, and submit it; voting is impossible by design. | +| [`bun-axi`](https://github.com/mlegls/bun-axi) | mlegls | Bun | Run Bun tests and package.json scripts and get counts, failure locations, load errors, and tsc/oxlint diagnostics instead of raw logs - plus dependency and npm registry lookups. | +| [`router-axi`](https://github.com/Azd325/router-axi) | Azd325 | Router / TR-064 | Agent-ergonomic router inspection CLI - read-only TR-064 inspection (device, WAN, traffic, calls, devices, leases, Wi-Fi, guest Wi-Fi, port forwards) plus confirmed mutations (`wifi enable\|disable`, `reboot`) and configuration backup over documented FRITZ!Box TR-064 interfaces. | +| [`google-marketing-axi`](https://github.com/elliottkan/google-marketing-axi) | elliottkan | Google Analytics / Tag Manager | Run GA4 reports, realtime views, and dimension/metric search, and inspect or edit Google Tag Manager tags, triggers, and variables with field-level diffs, --dry-run, and fingerprinted updates - version snapshots stop short of publishing by design. | +| [`hey-axi`](https://github.com/TangentialSolutions/hey-axi) | TangentialSolutions | HEY email | HEY email, calendars, todos, habits, journal, and time tracking over Basecamp's official `hey` CLI - live home view, `setup hooks` and `setup scope`, minimal TOON fields with counts and `--full`, and send safety: compose and reply save drafts unless `--allow-send`. | +| [`hass-axi`](https://github.com/dmealing/hass-axi) | dmealing | Home Assistant | Read and update the entity, area, and device registries that only the WebSocket API exposes, call services with a capability pre-check and an explained refusal, and summarise sensor history, logbook, and recorder statistics with their data-quality caveats - `HASS_AXI_READ_ONLY` refuses every write on both transports. | diff --git a/catalog.yaml b/catalog.yaml index bde2657e..ad4c7b1b 100644 --- a/catalog.yaml +++ b/catalog.yaml @@ -1252,3 +1252,48 @@ community: - "src/shape.js passes HEY's next-command hints (breadcrumbs) through as hey-axi suggestions with --account and --base-url carried, replaces existing --page/--all in paging hints, shell-quotes scope values, and adds a view/show or create suggestion when HEY gives none; the wrapper does not judge each hint's relevance, and one empty-list fallback in src/cli.js omits the carried selectors. src/cli.js and src/examples.js render per-command help with arguments, every flag's type and default, global flags, and two or three examples offline; setup hooks and setup scope help list every default." - "npm test (142 tests against a fake hey) passed locally at this revision; these are wrapper-source and fake-backend observations. Upstream HEY error wording, paging, and schemas, and real harness hook delivery were not independently verified." exception: "Three behaviors are intentional design choices by the maintainer: HEY's own next-command hints are kept as suggestions (rewritten to hey-axi with account selectors carried) rather than filtered for relevance; HEY's interactive commands are refused unless the explicit --interactive opt-in is passed; and the home view and session hook are account-wide by default, with directory scope opt-in through setup scope. The reviewer treats the first and third as partial against principles 9 and 7 and the opt-in as consistent with principle 6. Remaining source gaps: an empty result is labelled 0 total without proof of completeness (principle 4), error-line cleaning is pattern-based so some dependency text can pass through and no-op detection depends on HEY's wording (principle 6), one empty-list suggestion drops --account (principle 9), and journal/clip/snippet lists keep a truncated content preview (principle 2). Observations apply to the pinned wrapper source, not independently verified upstream HEY behavior." + - name: hass-axi + url: https://github.com/dmealing/hass-axi + author: dmealing + domain: Home Assistant + description: "Read and update the entity, area, and device registries that only the WebSocket API exposes, call services with a capability pre-check and an explained refusal, and summarise sensor history, logbook, and recorder statistics with their data-quality caveats - `HASS_AXI_READ_ONLY` refuses every write on both transports." + admission: + status: exception + reviewed_revision: 5555f1323d8b27c5aa1dd36ebbf6b7b6f2e8222c + reviewed_components: + - pyproject.toml + - src/hass_axi/__init__.py + - src/hass_axi/cli.py + - src/hass_axi/errors.py + - src/hass_axi/output.py + - src/hass_axi/toon.py + - src/hass_axi/readonly.py + - src/hass_axi/rest.py + - src/hass_axi/ws.py + - src/hass_axi/config.py + - src/hass_axi/hooks.py + - src/hass_axi/commands/_common.py + - src/hass_axi/commands/home.py + - src/hass_axi/commands/context.py + - src/hass_axi/commands/setup.py + - src/hass_axi/commands/state.py + - src/hass_axi/commands/sensor.py + - src/hass_axi/commands/logbook.py + - src/hass_axi/commands/statistics.py + - src/hass_axi/commands/service.py + - src/hass_axi/commands/template.py + - src/hass_axi/commands/entity.py + - src/hass_axi/commands/area.py + - src/hass_axi/commands/device.py + - src/hass_axi/commands/api.py + - src/hass_axi/commands/wscmd.py + - skills/hass-axi/SKILL.md + source_observations: + - "Tag v0.8.0 is 5555f1323d8b27c5aa1dd36ebbf6b7b6f2e8222c. pyproject.toml declares the `hass-axi` console script (hass_axi.cli:main) with dependencies axi-toolkit>=0.3.0 and websockets>=13.0, and src/hass_axi/__init__.py carries version 0.8.0. The tool was published as `ha-axi` up to 0.7.1 and renamed; it is unrelated to the batamire/ha-axi entry above." + - "src/hass_axi/cli.py is the single error boundary: an AxiError renders as a structured `error`/`code`/`class`/`help` document on stdout with the error's exit code, and any other exception renders as INTERNAL_ERROR instead of a raw traceback. src/hass_axi/errors.py maps usage errors to exit 2 and every other failure to exit 1. An unknown flag is refused by name with the valid flags for that subcommand (UNKNOWN_FLAG, exit 2), an unknown command and a missing subcommand list the valid ones, and `-v`/`--version` print the tool name and version." + - "src/hass_axi/toon.py is an in-tree TOON encoder and src/hass_axi/output.py is the one output boundary: TOON by default with `--json` and `--human` modes, registered secrets redacted before anything reaches stdout or stderr, and `truncate` appending the original length. src/hass_axi/commands/state.py, service.py, and template.py truncate long attribute, description, and rendered-template text with a `--full` hint. List commands print shown, matched, and total counts with a larger-`--limit` suggestion; `entity list`, `device list`, and `state list` default to three fields and `statistics list` to four, with `--fields` selecting from the wider set." + - "src/hass_axi/readonly.py classifies every subcommand and declared WebSocket command as read, write, or dynamic, treats anything unclassified as a write, and refuses writes with READ_ONLY (exit 2) when HASS_AXI_READ_ONLY is non-empty; src/hass_axi/rest.py and src/hass_axi/ws.py enforce the same gate on their own transports. src/hass_axi/commands/api.py treats only GET, HEAD, and OPTIONS as reads, and src/hass_axi/ws.py classifies a `ws --raw` type no declaration names as a write. src/hass_axi/config.py takes the URL and token from the environment only (no token flag or credential file), and src/hass_axi/rest.py refuses a redirect that changes scheme or host instead of forwarding the Authorization header." + - "src/hass_axi/commands/service.py pre-checks the capability a service publishes for area and device targets (UNSUPPORTED_CAPABILITY, with `--no-check` to send anyway), exits 1 with NO_ENTITIES_TARGETED when a target reached nothing, and explains a refused call from the service model (for example UNKNOWN_SERVICE_FIELD listing the accepted fields). src/hass_axi/commands/entity.py, area.py, and device.py report `already matches the requested values, no change made` for an update that already holds, and `area create` reports an existing area of the same name instead of failing." + - "src/hass_axi/commands/home.py is the no-argument live view (entity counts by domain, unavailable count, next-step help). src/hass_axi/hooks.py installs a SessionStart hook for Claude Code and Codex and a managed OpenCode plugin only when `hass-axi setup hooks` runs (src/hass_axi/commands/setup.py); the hook runs `hass-axi context`, which src/hass_axi/commands/context.py writes to need no connection or credential and to exit 0. The skill is produced by `hass-axi setup skill`, which generates skills/hass-axi/SKILL.md from the command table and has a `--check` mode for staleness; the committed copy is current at the pin." + - "Gaps observed at the pin: src/hass_axi/commands/sensor.py defaults list rows to six fields and src/hass_axi/commands/logbook.py to five. src/hass_axi/commands/api.py and src/hass_axi/commands/wscmd.py print the whole response with no size truncation. `service call`, write-method `api` requests, and write `ws` commands are sent without a confirmation or preview flag; the capability pre-check and HASS_AXI_READ_ONLY are the only gates. `setup hooks` has no status or removal subcommand and installs no session-end hook. The bare home view prints the description and setup help but exits 1 when HA_URL/HA_TOKEN are unset or Home Assistant is unreachable." + exception: "Principle 2 is partial: `sensor list` defaults to six fields and `logbook get` to five. Principle 3 is partial: `api` and `ws` output is not size-truncated. Principle 6 is partial: `service call` and the raw `api`/`ws` write paths mutate without a confirmation or preview step, relying on the capability pre-check and the opt-in `HASS_AXI_READ_ONLY` switch. Principle 7 lacks hook status/removal and session-end capture. Principle 8 home view exits 1 without configuration or a reachable server. Observations apply to the pinned wrapper source, not independently verified Home Assistant behavior." diff --git a/docs/index.html b/docs/index.html index 7b9f4ee5..1b06e2a7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1751,6 +1751,24 @@

The [AXI catalog].

save drafts unless --allow-send. + + + hass-axi + + dmealing + Home Assistant + + Read and update the entity, area, and device registries that + only the WebSocket API exposes, call services with a + capability pre-check and an explained refusal, and summarise + sensor history, logbook, and recorder statistics with their + data-quality caveats - + HASS_AXI_READ_ONLY refuses every write on both + transports. + +