thecatapi-cli 0.1.1

package/README.md

@@ -0,0 +1,72 @@
+# thecatapi-cli
+
+Unofficial CLI for [The Cat API](https://thecatapi.com). Made with [api2cli.dev](https://api2cli.dev).
+
+> **Note:** This is a community-maintained project and is not officially affiliated with or endorsed by The Cat API.
+
+## Install
+
+```bash
+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
+
+```bash
+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
+
+| Command | Description |
+|---------|-------------|
+| `thecatapi-cli images search` | Search random cat images |
+| `thecatapi-cli images search --limit 5 --has-breeds` | Search with filters |
+| `thecatapi-cli images list` | List 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
+
+| Command | Description |
+|---------|-------------|
+| `thecatapi-cli breeds list` | List 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
+
+| Command | Description |
+|---------|-------------|
+| `thecatapi-cli favourites list` | List favourited images |
+| `thecatapi-cli favourites create --image-id <id>` | Add to favourites |
+| `thecatapi-cli favourites delete <id>` | Remove from favourites |
+
+### votes
+
+| Command | Description |
+|---------|-------------|
+| `thecatapi-cli votes list` | List your votes |
+| `thecatapi-cli votes create --image-id <id> --value 1` | Upvote an image |
+| `thecatapi-cli votes delete <id>` | Delete a vote |
+
+### facts
+
+| Command | Description |
+|---------|-------------|
+| `thecatapi-cli facts list` | Get random cat facts |
+| `thecatapi-cli facts list --limit 10` | Get multiple facts |
+
+## Global Flags
+
+All commands support: `--json`, `--format <text|json|csv|yaml>`, `--verbose`, `--no-color`, `--no-header`

package/bun.lock

@@ -0,0 +1,32 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "thecatapi-cli",
+      "dependencies": {
+        "commander": "^13.0.0",
+        "picocolors": "^1.1.0",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+        "typescript": "^5.7.0",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.10", "", { "dependencies": { "bun-types": "1.3.10" } }, "sha512-0+rlrUrOrTSskibryHbvQkDOWRJwJZqZlxrUs1u4oOoTln8+WIXBPmAuCF35SWB2z4Zl3E84Nl/D0P7803nigQ=="],
+
+    "@types/node": ["@types/node@25.3.5", "", { "dependencies": { "undici-types": "~7.18.0" } }, "sha512-oX8xrhvpiyRCQkG1MFchB09f+cXftgIXb3a7UUa4Y3wpmZPw5tyZGTLWhlESOLq1Rq6oDlc8npVU2/9xiCuXMA=="],
+
+    "bun-types": ["bun-types@1.3.10", "", { "dependencies": { "@types/node": "*" } }, "sha512-tcpfCCl6XWo6nCVnpcVrxQ+9AYN1iqMIzgrSKYMB/fjLtV2eyAVEg7AxQJuCq/26R6HpKWykQXuSOq/21RYcbg=="],
+
+    "commander": ["commander@13.1.0", "", {}, "sha512-/rFeCpNJQbhSZjGVwO9RFV3xPqbnERS8MmIQzCtD/zl6gpJuV/bMLuN92oG3F7d8oDEHHRrujSXNUr8fpjntKw=="],
+
+    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.18.2", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],
+  }
+}