axshared

Common utilities and types for the ax* package suite, plus a CLI for querying agent and auth metadata

Quick Start

# Run without installing
npx -y axshared agents list
npx -y axshared auth-types list

Installation

# Install globally
npm install -g axshared

# Or use pnpm
pnpm add -g axshared

# Run without installing
npx -y axshared <command>

Prerequisites

• Node.js >= 22.19.0
• pnpm (recommended) or npm, plus npx for one-off runs
• jq for JSON filtering in examples (optional but recommended)

Usage

Run axshared --help for all available options. Examples prefer long flags (--json, --kind) and quote string values to avoid shell expansion.

# List agents
axshared agents list
axshared agents list --json

# Get agent details
axshared agents get 'claude'
axshared agents get 'codex' --json

# List auth types (with optional filter)
axshared auth-types list
axshared auth-types list --kind 'api-key'
axshared auth-types list --kind 'subscription' --json

# Get auth type details
axshared auth-types get 'anthropic-api'
axshared auth-types get 'github-copilot' --json

# Extract just the CLI names
axshared agents list | tail -n +2 | cut -f1

# Get all agent repository URLs
axshared agents list | tail -n +2 | cut -f1 \
  | xargs -I{} axshared agents get "{}" --json \
  | jq -r '.sourceCode // empty'

# Count auth types by kind
axshared auth-types list | tail -n +2 | cut -f2 | sort | uniq -c

# Filter to API key auth types
axshared auth-types list | tail -n +2 | awk -F'\t' '$2=="api-key"'

# Get the environment variable for an API key auth type
axshared auth-types get 'anthropic-api' --json | jq -r '.envVar'

Output Formats

By default, list commands emit a tab-separated table with a header line, and get commands emit a labeled, human-readable block. Use --json with agents or auth-types list/get to emit pretty-printed JSON for scripting.

Agent Rule

Add to your CLAUDE.md or AGENTS.md:

# Rule: `axshared` Usage

Run `npx -y axshared --help` to learn available options.

Use axshared to query metadata about AI agent CLI tools (Claude Code, Codex,
Gemini CLI, etc.) and their supported authentication methods. Useful for
understanding which credentials work with which agents.

Library Usage

Install the library:

npm install axshared
# or
pnpm add axshared

axshared is ESM-only, so use import:

import {
  getAllAgents,
  getAgent,
  getAllAuthTypes,
  getAuthType,
  getAuthTypesForAgent,
  getAgentsForAuthType,
} from "axshared";

// Get all agents
const agents = getAllAgents();

// Get a specific agent
const claude = getAgent("claude");
console.log(claude.sourceCode); // https://github.com/anthropics/claude-code

// Get auth types supported by an agent
const authTypes = getAuthTypesForAgent("claude");

// Get agents that support an auth type
const supportingAgents = getAgentsForAuthType("anthropic-api");

License

MIT