GitHub OpenBot Plugin

This plugin lets OpenBot interact with your GitHub account, enabling you to browse repositories, manage issues, and work with pull requests through natural language or direct tool calls.

Features

• List Repositories: View repositories for the authenticated user.
• Get Repository: Get detailed information about a repository.
• List Issues: See open or closed issues for a repository.
• Create Issue: Open a new issue.
• List Pull Requests: See pull requests for a repository.
• Get Pull Request: Get details about a specific pull request.
• Create Pull Request: Open a new pull request.
• Natural Language Support: Ask the agent about your repos and it will summarize results.

Configuration

To use this plugin, you need a GitHub Personal Access Token. You can create one in your GitHub Developer Settings with repo scope.

Config Schema

• githubToken (Required): Your GitHub Personal Access Token.
• openaiApiKey (Optional): OpenAI API key for natural language support (can also be set via environment).

Usage

Natural Language

You can ask things like:

• "What repositories do I have on GitHub?"
• "Show me the open issues for owner/repo"
• "Create an issue in owner/repo titled 'Fix login bug'"
• "List the pull requests for owner/repo"

Tools

The plugin provides the following tools:

• list_repos: List repositories for the authenticated user.
• get_repo: Get repository details.
• list_issues: List issues for a repository.
• create_issue: Create a new issue.
• list_pull_requests: List pull requests for a repository.
• get_pull_request: Get pull request details.
• create_pull_request: Create a new pull request.

Installation

1. Clone this repository into your OpenBot plugins directory.
2. Run npm install.
3. Run npm run build.
4. Configure the plugin in your AGENT.md or via the OpenBot UI.