@radzor/github-bot

Interact with the GitHub REST API. Create issues, post comments, trigger workflows, manage pull requests, and read repository data. Supports both personal access tokens and GitHub App authentication.

Automationv0.1.0typescriptpythonServergithubgitissuespull-requestciautomationapibotby Radzor

Install

View source on GitHub →

$npx radzor@latest add github-bot

⚠ Constraints: Use a fine-grained PAT with minimal required scopes. triggerWorkflow() requires the workflow to have a workflow_dispatch trigger. Rate limit: 5000 requests/hour for authenticated requests.

Inputs

Name	Type	Default	Description
token*	string	—	GitHub Personal Access Token (ghp_...) or GitHub App installation token.GITHUB_TOKEN
owner*	string	—	Repository owner (user or organization name).
repo*	string	—	Repository name.
baseUrl	string	https://api.github.com	GitHub API base URL. Override for GitHub Enterprise Server.

token*string

GitHub Personal Access Token (ghp_...) or GitHub App installation token.

GITHUB_TOKEN

{ "llm": { "constraints": "Use a fine-grained PAT with minimal required scopes. triggerWorkflow() requires the workflow to have a workflow_dispatch trigger. Rate limit: 5000 requests/hour for authenticated requests.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/github-bot", "tags": [ "github", "git", "issues", "pull-request", "ci", "automation", "api", "bot" ], "events": [ { "name": "onIssueCreated", "payload": { "url": "string", "title": "string", "number": "number" }, "description": "Fired when an issue is created." }, { "name": "onCommentPosted", "payload": { "id": "number", "url": "string", "issueNumber": "number" }, "description": "Fired when a comment is posted." }, { "name": "onError", "payload": { "code": "string", "status": "number", "message": "string" }, "description": "Fired on GitHub API error." } ], "inputs": [ { "name": "token", "type": "string", "envVar": "GITHUB_TOKEN", "required": true, "description": "GitHub Personal Access Token (ghp_...) or GitHub App installation token." }, { "name": "owner", "type": "string", "required": true, "description": "Repository owner (user or organization name)." }, { "name": "repo", "type": "string", "required": true, "description": "Repository name." }, { "name": "baseUrl", "type": "string", "default": "https://api.github.com", "required": false, "description": "GitHub API base URL. Override for GitHub Enterprise Server." } ], "radzor": "1.0.0", "actions": [ { "name": "createIssue", "params": [ { "name": "title", "type": "string", "description": "Issue title." }, { "name": "body", "type": "string", "description": "Issue body (Markdown)." }, { "name": "labels", "type": "string[]", "required": false, "description": "Label names to apply." }, { "name": "assignees", "type": "string[]", "required": false, "description": "GitHub usernames to assign." } ], "returns": "Promise<{ number: number; url: string; id: number }>", "description": "Create a new issue in the repository." }, { "name": "createComment", "params": [ { "name": "issueNumber", "type": "number", "description": "Issue or PR number to comment on." }, { "name": "body", "type": "string", "description": "Comment body (Markdown)." } ], "returns": "Promise<{ id: number; url: string }>", "description": "Post a comment on an issue or pull request." }, { "name": "triggerWorkflow", "params": [ { "name": "workflow", "type": "string", "description": "Workflow file name (e.g. deploy.yml) or ID." }, { "name": "ref", "type": "string", "description": "Branch or tag to run on." }, { "name": "inputs", "type": "Record<string, string>", "required": false, "description": "Workflow dispatch inputs." } ], "returns": "Promise<void>", "description": "Trigger a workflow_dispatch event to run a GitHub Actions workflow." }, { "name": "getPullRequest", "params": [ { "name": "number", "type": "number", "description": "Pull request number." } ], "returns": "Promise<{ number: number; title: string; state: string; mergeable: boolean; headSha: string }>", "description": "Fetch pull request details." }, { "name": "mergePullRequest", "params": [ { "name": "number", "type": "number", "description": "Pull request number to merge." }, { "name": "method", "type": "'merge' | 'squash' | 'rebase'", "required": false, "description": "Merge strategy." } ], "returns": "Promise<{ sha: string; merged: boolean }>", "description": "Merge a pull request." }, { "name": "createRelease", "params": [ { "name": "tag", "type": "string", "description": "Tag name for the release (e.g. v1.2.0)." }, { "name": "name", "type": "string", "description": "Release title." }, { "name": "body", "type": "string", "required": false, "description": "Release notes (Markdown)." }, { "name": "draft", "type": "boolean", "required": false, "description": "Create as draft." } ], "returns": "Promise<{ id: number; url: string; uploadUrl: string }>", "description": "Create a GitHub release." } ], "outputs": [ { "name": "apiResult", "type": "unknown", "description": "Raw API response from GitHub." } ], "runtime": "server", "version": "0.1.0", "category": "automation", "languages": [ "typescript", "python" ], "description": "Interact with the GitHub REST API. Create issues, post comments, trigger workflows, manage pull requests, and read repository data. Supports both personal access tokens and GitHub App authentication.", "dependencies": { "packages": {} }, "composability": { "connectsTo": [ { "event": "onIssueCreated", "description": "Notify team or auto-triage issues with LLM.", "compatibleWith": [ "@radzor/slack-bot.action.sendMessage.text", "@radzor/email-send.action.send.message", "@radzor/llm-completion.action.complete.prompt" ] } ] } }

@radzor/github-bot

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History