Getting Started

Install the api2cli skill in your AI agent. Tell it what API you need. Done. Your agent handles everything.

1. Install the Skill

npx skills add Melvynx/api2cli

That's it. The skills CLI auto-detects your coding agents (Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, and 37+ more) and installs the skill to all of them.

Options

# Install to specific agents only
npx skills add Melvynx/api2cli -a claude-code -a cursor

# Install globally (available across all projects)
npx skills add Melvynx/api2cli -g

# Install specific skill from the repo
npx skills add Melvynx/api2cli --skill api2cli

# Non-interactive (CI/CD friendly)
npx skills add Melvynx/api2cli -g -a claude-code -y

# Direct path to skill
npx skills add https://github.com/Melvynx/api2cli/tree/dev/skills/api2cli

# List available skills without installing
npx skills add Melvynx/api2cli --list

2. Ask Your Agent

Just tell your agent what you need in plain English:

> Use api2cli to create CLI for typefully api

⏺ I'll create a CLI for the Typefully API. Let me start by discovering the API.
  → Finding API docs...
  → Base URL: https://api.typefully.com
  → Auth: Bearer token
  → Generating resources: drafts, notifications, accounts
  → Building CLI...
  → Linking to PATH...

✅ typefully-cli is ready to use!

More examples:

Use api2cli to create CLI for stripe api

Use api2cli to create CLI for notion api

Use api2cli to create CLI for linear api

Your agent automatically:

  1. Discovers the API documentation
  2. Identifies endpoints, auth type, and base URL
  3. Generates a standardized CLI with all resources
  4. Builds it and adds it to your PATH
  5. Tests the connection

3. Use Your CLI

Once the agent finishes, your CLI is ready:

# Set your API token
typefully-cli auth set "typ_xxx"

# Start using it
typefully-cli drafts list
typefully-cli drafts create --text "Hello world"

# Works with any agent via --json
typefully-cli drafts list --json

Or Install an Existing CLI

Before creating a new CLI, check the registry. Someone may have already built it:

# Install from GitHub repo
npx api2cli install owner/repo

This clones the repo, installs dependencies, builds, links to your PATH, and symlinks the AgentSkill to your coding agents. One command, fully ready.

Manage Your Skills

# List installed skills
npx skills list

# Remove a skill
npx skills remove api2cli
Want to go deeper?

Learn about the resource pattern, all CLI commands, or how to publish to the marketplace.