← Back to CLIs
pyrytakala

The Cat API

Manage thecatapi via CLI - images, breeds, favourites, votes, facts. Use when user mentions 'thecatapi' or wants to interact with the thecatapi API.

Install

$ npx api2cli install thecatapi-cli

Details

Auth type: api-key
Version: 0.1.0
Author: pyrytakala
Views: 0

README

thecatapi-cli

CLI for The Cat API. Made with api2cli.dev.

Install

npx api2cli install thecatapi

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Usage

thecatapi-cli auth set "your-api-key"
thecatapi-cli auth test
thecatapi-cli --help

Get a free API key at https://thecatapi.com/signup

Resources

images

CommandDescription
thecatapi-cli images searchSearch random cat images
thecatapi-cli images search --limit 5 --has-breedsSearch with filters
thecatapi-cli images listList your uploaded images
thecatapi-cli images get <id>Get a specific image
thecatapi-cli images upload <file>Upload a cat image
thecatapi-cli images delete <id>Delete an uploaded image

breeds

CommandDescription
thecatapi-cli breeds listList all cat breeds
thecatapi-cli breeds get <id>Get breed details (e.g. abys, beng)
thecatapi-cli breeds search <query>Search breeds by name
thecatapi-cli breeds facts <id>Get facts about a breed

favourites

CommandDescription
thecatapi-cli favourites listList favourited images
thecatapi-cli favourites create --image-id <id>Add to favourites
thecatapi-cli favourites delete <id>Remove from favourites

votes

CommandDescription
thecatapi-cli votes listList your votes
thecatapi-cli votes create --image-id <id> --value 1Upvote an image
thecatapi-cli votes delete <id>Delete a vote

facts

CommandDescription
thecatapi-cli facts listGet random cat facts
thecatapi-cli facts list --limit 10Get multiple facts

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header