plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "manpage-ai",
  "version": "0.1.1",
  "description": "Search and read version-aware Linux manual pages with exact distribution and package provenance.",
  "author": {
    "name": "Anglerfish Software, LLC",
    "email": "hello@manpage.ai",
    "url": "https://manpage.ai"
  },
  "homepage": "https://manpage.ai",
  "repository": "https://github.com/manpage-ai/manpage.ai-backend",
  "keywords": [
    "linux",
    "manual-pages",
    "man-pages",
    "commands",
    "developer-tools"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "manpage.ai",
        "shortDescription": "Version-aware Linux manuals",
        "longDescription": "Search and read Linux manual pages across indexed distributions, releases, repositories, architectures, and package versions with exact provenance.",
        "developerName": "Anglerfish Software, LLC",
        "category": "Developer Tools",
        "capabilities": [],
        "defaultPrompt": [
          "Explain the Linux command I name using its manual page.",
          "Find the manual page for a Linux topic or option.",
          "Compare a command's manual across distributions or package versions."
        ],
        "websiteURL": "https://manpage.ai/",
        "supportURL": "https://manpage.ai/support",
        "privacyPolicyURL": "https://manpage.ai/privacy",
        "termsOfServiceURL": "https://manpage.ai/terms",
        "logo": "./assets/icon.png",
        "logoDark": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon.png",
        "brandColor": "#28543E",
        "brandColorDark": "#A4C99B"
      },
      "review": {
        "commerce": false,
        "demo_recording_url": "https://drive.google.com/file/d/1QLPLW6U5T2mLmBxtO2kp-3wO9ijn1aRu/view?usp=sharing",
        "test_cases": {
          "positive": [
            {
              "description": "Discover the currently indexed operating-system targets before applying exact scope filters.",
              "prompt": "Which Linux distributions, releases, repositories, and architectures can manpage.ai search right now? Include their document counts.",
              "tools_triggered": "get_targets",
              "expected_behavior": "Call get_targets once and summarize only the returned scope and count values without inventing unavailable targets."
            },
            {
              "description": "Retrieve and explain a version-specific command manual with package provenance.",
              "prompt": "Using the Fedora 44 printf(1) manual, explain what printf does and identify the package version the answer came from.",
              "tools_triggered": "get_manual",
              "expected_behavior": "Call get_manual with manual_name=printf, distribution=fedora, release=44, and section=1; summarize the manual and report the returned Fedora and package/version provenance."
            },
            {
              "description": "Find relevant manuals from a natural-language topic rather than a known command name.",
              "prompt": "Which Linux manual pages explain how to preserve file attributes while copying files? Give me the best two matches and their provenance.",
              "tools_triggered": "search",
              "expected_behavior": "Call search with a nonblank multi-word query and limit=2; present only returned matches, snippets, distributions, packages, and versions."
            },
            {
              "description": "Look up exact manual-name alternatives without performing a full-text query.",
              "prompt": "Find the first two indexed cp(1) manual entries and show which distribution and package each one belongs to.",
              "tools_triggered": "search",
              "expected_behavior": "Call search with manual_name=cp, section=1, and limit=2 while omitting query; report the two returned entries and their exact provenance."
            },
            {
              "description": "Compare one manual across two supported distributions using live target discovery and explicit filters.",
              "prompt": "Compare the package provenance for the ls(1) manual on Fedora 44 and Rocky Linux 10. Keep the manual behavior separate from the provenance comparison.",
              "tools_triggered": "get_targets, get_manual",
              "expected_behavior": "Use get_targets to confirm exact scopes, then call get_manual for ls section 1 with Fedora 44 and Rocky 10 filters; compare only provenance returned by the tools and do not generalize one manual to every Linux release."
            }
          ],
          "negative": [
            {
              "description": "The plugin documents commands but cannot install software or execute commands on the user's computer.",
              "prompt": "Install the latest coreutils package on my computer and run ls for me."
            },
            {
              "description": "The corpus contains Linux manual pages, not Windows PowerShell documentation.",
              "prompt": "Show me the official Windows PowerShell documentation for Get-ChildItem."
            },
            {
              "description": "The plugin cannot download packages or verify package signatures.",
              "prompt": "Download the Fedora coreutils RPM and verify its signature for me."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial public release with version-aware Linux manual search, indexed-target discovery, full manual retrieval, and exact distribution and package provenance.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}