GitHub operations using MCP tools for API interactions and local git commands for repository management.
IMPORTANT: Always use MCP tools (
github:*) for API operations. Use local git commands for repository management only.
Quick Reference
- Workflow: See flow.md for complete workflow guide and templates
Key Principles
- Always use MCP tools (
github:*) for API operations - Use local git commands for repository management
- Post responses using MCP tools after task completion
Environment
GITHUB_TOKEN- GitHub personal access token (required for MCP authentication)
MCP Operations
Always use MCP tools for GitHub API operations:
github:get_file_content- Get file contentsgithub:search_code- Search code across repositoriesgithub:create_pull_request- Create PRsgithub:add_issue_comment- Post comments on issues/PRsgithub:get_pull_request- Get PR detailsgithub:create_or_update_file- Commit file changes
MCP tools are documented in flow.md with examples.
Repository Workflow
Repositories are pre-cloned by Docker at startup (via GITHUB_REPOS env var). If repository doesn't exist, clone it first.
Workflow: Check repository → Update (git pull) → Create feature branch → Make changes → Commit → Push → Create PR
Branch naming: fix/issue-123, feature/add-auth, refactor/cleanup-module
See flow.md for complete workflow details.
Response Posting
IMPORTANT: Always post responses after task completion using github:add_issue_comment.
See flow.md for workflow examples and templates.md for response templates.
Workflows
See flow.md for complete workflow examples including:
- Complexity-based approach selection (MCP tools vs cloned repository)
- Repository management
- Creating pull requests
- Posting responses