All notable changes to github-dev-assistant are documented in this file.
The format follows Keep a Changelog. Versioning follows Semantic Versioning.
- Fix path traversal vulnerability in
github_download_file(issue #57)- Added
validateSavePathto reject paths outside/tmpbefore any write - Relative paths (e.g.
../../etc/passwd) are now rejected with a clear error - Absolute paths outside
/tmp(e.g./etc/passwd,/home/user/.ssh/authorized_keys) are rejected - Path traversal through
/tmp/../etcis resolved and rejected - On rejection the tool returns
save_errorin the result data without writing any file
- Added
- Added
scope: "dm-only"togithub_download_file— local filesystem writes are a destructive operation; the tool is now restricted to private DM chats - Added
scope: "dm-only"togithub_delete_file— permanently deleting files from a repository is a destructive operation; restricted to private DM chats
- Extended repository operations (8 new tools) based on github-mcp-server feature parity
github_fork_repo— fork a repository into the authenticated user's account or an organizationgithub_search_repos— search GitHub repositories with advanced search qualifiersgithub_list_branches— list all branches with their SHA and protection statusgithub_push_files— commit multiple files in a single Git operation using the Trees APIgithub_get_repo_tree— get the complete file tree of a repository (recursively)github_list_tags— list tags with their commit SHAsgithub_list_releases— list all releases with tag, name, and publish dategithub_get_latest_release— get the latest stable release with assets
- Extended PR and issue search operations (4 new tools)
github_search_issues— search issues and PRs across GitHub using search syntaxgithub_update_pr— update a PR's title, body, state, or base branchgithub_add_pr_review— submit a review (APPROVE, REQUEST_CHANGES, or COMMENT)github_get_job_logs— get logs and step details for a specific workflow job
- User and social operations (8 new tools)
github_get_me— get the authenticated user's full profilegithub_search_users— search GitHub users and organizationsgithub_list_notifications— list GitHub notifications (unread or all)github_star_repo— star a repositorygithub_unstar_repo— unstar a repositorygithub_list_gists— list gists for a user or the authenticated usergithub_get_gist— read gist content with all filesgithub_create_gist— create a new gist (public or secret)
- Security operations (2 new tools)
github_list_code_scanning_alerts— list code scanning (SAST) alerts by state and severitygithub_list_dependabot_alerts— list Dependabot vulnerability alerts with CVE and package info
- Discussion operations (2 new tools)
github_list_discussions— list repository discussions with category filtering (GraphQL)github_get_discussion— get a discussion with its body, comments, and answer status (GraphQL)
- GitHub client improvements
- Added
graphql()method for GitHub GraphQL API v4 (used by discussions)
- Added
- Plugin version bumped from
2.0.0to3.0.0 - Plugin description updated to reflect complete feature set
- Total tool count increased from 34 to 57
- Extended file operations (4 new tools)
github_delete_file— delete a file from a repository (requires file SHA fromgithub_get_file)github_list_directory— list contents of a directory with file types, sizes, and SHAsgithub_search_code— search for code patterns within a repository using GitHub's code search APIgithub_download_file— download a file and optionally save it to a local path
- Commit operations (2 new tools)
github_list_commits— list commits with filtering by branch, path, and authorgithub_get_commit— get detailed commit info including changed files and diffs
- Extended issue/PR operations (5 new tools)
github_list_comments— list comments on an issue or pull requestgithub_update_issue— update title, body, labels, assignees, state, or milestonegithub_reopen_issue— reopen a closed issue with optional commentgithub_assign_issue— assign or clear assignees on an issuegithub_list_pull_request_reviews— list reviews (APPROVED/CHANGES_REQUESTED/COMMENTED) on a PR
- Repository information tools (3 new tools)
github_list_languages— list programming languages with byte counts and percentagesgithub_list_collaborators— list collaborators with permission levelsgithub_list_teams— list teams in a GitHub organization
- Extended workflow operations (3 new tools)
github_list_workflows— list all GitHub Actions workflows in a repositorygithub_list_workflow_runs— list workflow runs with filtering by branch, status, and workflowgithub_cancel_workflow_run— cancel a currently running workflow run
- Label operations (3 new tools)
github_list_labels— list all labels with colors and descriptionsgithub_create_label— create a new label with custom color and descriptiongithub_delete_label— delete a label from a repository
- GitHub client improvements
DELETErequests now support a JSON body (required by GitHub's delete file API)
- Plugin version bumped from
1.0.0to2.0.0 - Plugin description updated to reflect expanded capabilities
- Total tool count increased from 14 to 34
- Initial release of the
github-dev-assistantplugin - Authorization (1 tool)
github_check_auth— verify current authentication status via Personal Access Token
- Repository management (2 tools)
github_list_repos— list user or organization repositories with filteringgithub_create_repo— create new repositories with optional license and gitignore
- File & commit operations (3 tools)
github_get_file— read files or list directories (base64 decode handled automatically)github_update_file— create or update files with commits (base64 encode handled automatically)github_create_branch— create branches from any ref
- Pull request management (3 tools)
github_create_pr— create pull requests with draft supportgithub_list_prs— list PRs with state, head, base, and sort filteringgithub_merge_pr— merge PRs withrequire_pr_reviewconfirmation policy
- Issue management (4 tools)
github_create_issue— create issues with labels, assignees, and milestonegithub_list_issues— list issues with extensive filtering optionsgithub_comment_issue— add comments to issues and PRsgithub_close_issue— close issues/PRs with optional comment and reason
- GitHub Actions (1 tool)
github_trigger_workflow— dispatch workflow_dispatch events with inputs
- Security
- All tokens stored exclusively via
sdk.secrets - Token redaction in error messages
require_pr_reviewconfirmation policy for destructive merge operations
- All tokens stored exclusively via