axshared

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

Quick Start

``bash


Run without installing


npx -y axshared agents list
npx -y axshared auth-types list
`

Installation

`bash


Install globally

npm install -g axshared

Or use pnpm

pnpm add -g axshared

Run without installing

npx -y axshared
`

Requirements

- Node.js >= 22.14.0

Usage

Run axshared --help for all available options.

`bash


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:

`markdown


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:

`bash
npm install axshared


or


pnpm add axshared
`

axshared is ESM-only, so use import:

`typescript
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