Back to home@vikasranax

dsh-plugin-cats

A DeepSeek Harness plugin that fetches random cat facts from a public API.

Stars
0
Language
TypeScript
Created
Aug 23, 2026
Updated
Aug 23, 2026
GitHub repo

Introduction

🐱 Cat Companion Tools for DeepSeek Harness

A DeepSeek Harness plugin that provides AI agents with tools to fetch random cat facts and images from public APIs.

✨ Features

  • get_cat_fact: Fetches a random, interesting fact about cats.
    • Optional Parameter: maxLength (number) - Limits the length of the fact in characters.
  • get_cat_image: Fetches a random cat image URL and displays it as a Markdown image.

📦 Installation

To install this plugin in your DeepSeek Harness profile, run:

git clone https://github.com/vikasranax/dsh-plugin-cats.git

cd dsh-plugin-cats

pnpm install

pnpm dsh web --patch ./cordis.yml

⚙️ Configuration

You can configure the default behavior of the plugin. If no configuration is provided, the plugin uses sensible defaults.

SettingTypeDefaultDescription
defaultMaxLengthnumber200The default maximum length for cat facts if not specified in the prompt.

Contributing

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This Project is licensed under the MIT License. See LICENCE.md

Acknowledgements

This plugin relies on the free public APIs.

https://catfact.ninja https://thecatapi.com