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>

Requirements

• Node.js >= 22.14.0

Usage

Run axshared --help for all available options.

# 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 -k 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 | while read cli _; do
  axshared agents get "$cli" --json | jq -r '.sourceCode // empty'
done

# 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'

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