weavetab.json

{
  "$schema": "https://weavetab.dev/schema/plugin.json",
  "name": "@weavetab/plugin-github",
  "displayName": "GitHub",
  "version": "1.3.0",
  "description": "Official Weavetab GitHub plugin — modular repository analysis, raw source reads, issues, pull requests, raw diffs, CLI commands, and active-tab DOM inspection without burning browser turns or API quota.",
  "entry": "dist/index.js",
  "agentsMd": "AGENTS.md",
  "author": {
    "name": "Weavetab",
    "url": "https://weavetab.dev",
    "role": "Core Team"
  },
  "license": "MIT",
  "homepage": "https://github.com/Weavetab/plugin-github",
  "repository": "https://github.com/Weavetab/plugin-github",
  "engines": {
    "weavetab": "^2.6.2",
    "node": ">=18.0.0"
  },
  "environments": [
    "mcp",
    "cli",
    "browser"
  ],
  "keywords": [
    "weavetab",
    "weavetab-plugin",
    "weavetab-official",
    "mcp",
    "github",
    "repository",
    "issues",
    "pull-requests"
  ],
  "defaultConfig": {
    "cacheTtlMs": 1800000,
    "maxReadLines": 200,
    "defaultIssueLimit": 5
  },
  "permissions": {
    "config": {
      "read": true,
      "write": true,
      "reason": "Read and persist isolated plugin settings."
    },
    "cdp": {
      "evaluate": true,
      "reason": "Reads URL and DOM on github.com without navigating or mutating."
    },
    "network": {
      "domains": [
        "api.github.com",
        "raw.githubusercontent.com",
        "github.com"
      ],
      "reason": "Fetches repository metadata, issues, PRs, raw files, and diffs from GitHub."
    },
    "tools": {
      "add": true,
      "reason": "Registers the 6 modular github_* MCP tools."
    },
    "commands": {
      "add": true,
      "reason": "Registers repo-summary and pr-diff CLI commands."
    },
    "prompts": {
      "add": true,
      "reason": "Registers /pr-review prompt utility."
    },
    "resources": {
      "add": true,
      "reason": "Registers @github://ratelimit resource utility."
    }
  },
  "tools": [
    {
      "name": "github_analyze",
      "description": "High-level repository reconnaissance: metadata, default branch, recursive file tree, and README preview. Results are cached in isolated storage.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "description": "Repository in 'owner/repo' format or GitHub URL (inferred from active tab if omitted)."
          }
        }
      }
    },
    {
      "name": "github_read",
      "description": "Fetch raw file contents from raw.githubusercontent.com with zero REST API quota consumption.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "description": "Repository in 'owner/repo' format or GitHub URL."
          },
          "paths": {
            "type": "array",
            "items": { "type": "string" },
            "description": "File paths relative to repository root."
          },
          "branch": {
            "type": "string",
            "description": "Target branch or tag (defaults to cached default branch or 'main')."
          },
          "line_range": {
            "type": "array",
            "items": { "type": "number" },
            "description": "Optional [start, end] 1-indexed line slice."
          }
        }
      }
    },
    {
      "name": "github_issues",
      "description": "Inspect a single issue with comments or list/search repository issues.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "description": "Repository in 'owner/repo' format or GitHub URL."
          },
          "number": {
            "type": "number",
            "description": "Specific issue number to fetch with timeline comments."
          },
          "search": {
            "type": "string",
            "description": "Search query string for repository issues."
          },
          "labels": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Filter by label names."
          },
          "state": {
            "type": "string",
            "enum": ["open", "closed", "all"],
            "description": "Issue state filter."
          },
          "limit": {
            "type": "number",
            "description": "Max issues to return (default 5)."
          }
        }
      }
    },
    {
      "name": "github_pull_request",
      "description": "Inspect a pull request (changed files, diff stats, comments) or list recent pull requests.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "description": "Repository in 'owner/repo' format or GitHub URL."
          },
          "number": {
            "type": "number",
            "description": "Specific pull request number."
          },
          "state": {
            "type": "string",
            "enum": ["open", "closed", "all"],
            "description": "PR state filter."
          },
          "limit": {
            "type": "number",
            "description": "Max PRs to return when listing (default 10)."
          }
        }
      }
    },
    {
      "name": "github_diff",
      "description": "Fetch raw unified diffs or git patches directly from github.com with zero REST API quota usage.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "repo": {
            "type": "string",
            "description": "Repository in 'owner/repo' format or GitHub URL."
          },
          "pull_number": {
            "type": "number",
            "description": "Pull request number to fetch diff for."
          },
          "commit_sha": {
            "type": "string",
            "description": "Commit SHA to fetch diff for."
          },
          "base": {
            "type": "string",
            "description": "Base branch or commit for compare diff."
          },
          "head": {
            "type": "string",
            "description": "Head branch or commit for compare diff."
          },
          "format": {
            "type": "string",
            "enum": ["diff", "patch"],
            "description": "Output format: 'diff' or 'patch'."
          }
        }
      }
    },
    {
      "name": "github_active_tab",
      "description": "Extract structured repository, PR, issue, or blob state from the active github.com browser tab via local CDP.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "scope": {
            "type": "string",
            "enum": ["auto", "summary", "files", "comments", "raw"],
            "description": "Extraction scope."
          }
        }
      }
    }
  ],
  "commands": [
    {
      "name": "repo-summary",
      "description": "Fetch repository metadata, default branch, file tree, and README snippet via CLI.",
      "usage": "weavetab plugin use github repo-summary --repo <owner/repo>",
      "options": [
        {
          "name": "repo",
          "type": "string",
          "description": "Repository in 'owner/repo' format or full GitHub URL",
          "required": true
        }
      ]
    },
    {
      "name": "pr-diff",
      "description": "Fetch unified diff and stats for a pull request directly from GitHub without API quota.",
      "usage": "weavetab plugin use github pr-diff --repo <owner/repo> --pull_number <n>",
      "options": [
        {
          "name": "repo",
          "type": "string",
          "description": "Repository in 'owner/repo' format",
          "required": true
        },
        {
          "name": "pull_number",
          "type": "number",
          "description": "Pull request number",
          "required": true
        }
      ]
    },
    {
      "name": "issue-search",
      "description": "Search open or closed repository issues by keyword directly via CLI.",
      "usage": "weavetab plugin use github issue-search --repo <owner/repo> --query <text>",
      "options": [
        {
          "name": "repo",
          "type": "string",
          "description": "Repository in 'owner/repo' format",
          "required": true
        },
        {
          "name": "query",
          "type": "string",
          "description": "Keywords to search",
          "required": true
        },
        {
          "name": "limit",
          "type": "number",
          "description": "Max issues to return (default 5)",
          "required": false
        }
      ]
    }
  ],
  "prompts": [
    {
      "name": "pr-review",
      "description": "Structured pull request review prompt for security, performance, and regression analysis.",
      "arguments": [
        {
          "name": "repo",
          "description": "Repository in owner/repo format",
          "required": true
        },
        {
          "name": "pr",
          "description": "Pull request number",
          "required": true
        }
      ]
    },
    {
      "name": "issue-triage",
      "description": "Structured issue triage prompt to diagnose root cause and plan implementation.",
      "arguments": [
        {
          "name": "repo",
          "description": "Repository in owner/repo format",
          "required": true
        },
        {
          "name": "issue",
          "description": "Issue number",
          "required": true
        }
      ]
    }
  ],
  "resources": [
    {
      "name": "github-ratelimit",
      "uri": "github://ratelimit",
      "description": "Current GitHub REST API rate-limit budget and quota status.",
      "mimeType": "application/json"
    },
    {
      "name": "github-context",
      "uri": "github://context",
      "description": "Active tab GitHub DOM context (current repository, branch, open PR, or issue metadata).",
      "mimeType": "application/json"
    }
  ]
}