antha

npm for AI agent files — find and use agent prompt files from the AgentAnthology registry.

AI coding agents like Claude Code, Cursor, and Gemini CLI are driven by markdown prompt files (CLAUDE.md, GEMINI.md, system prompts). antha lets you search a public registry of these files and write them directly to your project in seconds.

Installation

Requires Node.js 18+.

npm install -g @agentanthology/antha

Quick start

# Search the registry
antha search "nextjs typescript"

# Preview an agent
antha show bob/nextjs-engineer

# Write it to your project
antha use bob/nextjs-engineer

antha use writes to CLAUDE.md by default. Use -o <file> to specify a different path.

Commands

Registry

| Command | Description | |---|---| | antha search <query> | Search the public registry. Supports -t <tag> and --sort downloads\|stars\|newest | | antha show <pub/name> | Print an agent's full content to the terminal | | antha use <pub/name>[@version] | Fetch an agent and write it to a file | | antha my | List your published agents and personas |

Authentication

Authentication is only required for antha my. Searching, previewing, and using public agents works without an account.

| Command | Description | |---|---| | antha login | Sign in via browser. The token is returned to the CLI automatically | | antha logout | Sign out and remove saved credentials | | antha whoami | Show the currently logged-in user |

Agents and Personas

Agents are individual prompt files. Personas are curated collections of agents merged into a single file — useful for defining a complete AI engineering identity.

# Use a persona
antha use alice/full-stack-dev --persona

# Preview a persona
antha show alice/full-stack-dev --persona

Options

antha use

antha use <pub/name>[@version] [options]

Options:
  --persona       Fetch a persona instead of an agent
  -o, --output    File path to write to (e.g. GEMINI.md). Prompts if omitted.

antha search

antha search <query> [options]

Options:
  -t, --tag       Filter by tag (e.g. coding, security, writing)
  --sort          Sort by: downloads, stars, or newest (default: newest)

Registry model

• Agents are addressed as publisher/name slugs (e.g. alice/code-reviewer)
• Versions are semver — antha use alice/[email protected] always fetches exactly that version
• Published versions are immutable

Links

• Registry: agentanthology.com
• Issues: github.com/agentanthology/agentanthology