orthogonal-sh/github

GitHub

Create issues, pull requests, and manage repositories on GitHub. Connect your GitHub account to interact with repos, create issues, open PRs, and manage your GitHub workflow.

Requirements

• Install the orth CLI
• Connect your GitHub account at https://orthogonal.com/dashboard/integrations
• OAuth connection must be active (HTTP 428 response means not connected)

Actions

Create Issue

Create a new issue in a GitHub repository.

orth run github /create-issue --body '{
  "owner": "username",
  "repo": "repository-name",
  "title": "Bug: Login form validation error",
  "body": "When submitting invalid email, no error message appears."
}'

Parameters:

• owner (required) - Repository owner username or organization
• repo (required) - Repository name
• title (required) - Issue title
• body - Issue description and details
• labels - Array of label names to apply
• assignees - Array of usernames to assign
• milestone - Milestone number to associate with

List Repositories

Get a list of repositories for the authenticated user or organization.

orth run github /list-repos --body '{
  "type": "owner",
  "sort": "updated",
  "per_page": 20
}'

Parameters:

• sort - Sort repositories by (created, updated, pushed, full_name)
• type - Repository type (all, owner, public, private, member)
• direction - Sort direction (asc, desc)
• per_page - Number of repositories per page
• page - Page number for pagination
• since - Only repos updated after this date
• before - Only repos updated before this date
• raw_response - Return raw GitHub API response (true/false)

Create Pull Request

Open a new pull request between branches.

orth run github /create-pr --body '{
  "owner": "username",
  "repo": "repository-name",
  "head": "feature-branch",
  "base": "main",
  "title": "Add new feature",
  "body": "This PR adds the requested feature with tests."
}'

Parameters:

• owner (required) - Repository owner username or organization
• repo (required) - Repository name
• head (required) - Branch containing changes (source branch)
• base (required) - Branch to merge into (target branch)
• title - Pull request title
• body - Pull request description
• draft - Create as draft PR (true/false)
• issue - Issue number to convert to PR
• head_repo - Repository containing head branch (for forks)
• maintainer_can_modify - Allow maintainers to edit (true/false)

Star Repository

Star a GitHub repository to bookmark it.

orth run github /star-repo --body '{
  "owner": "octocat",
  "repo": "Hello-World"
}'

Parameters:

• owner (required) - Repository owner username or organization
• repo (required) - Repository name to star

Usage Examples

Create bug report:

orth run github /create-issue -b '{"owner":"myorg","repo":"webapp","title":"Login button not working","body":"Steps to reproduce:\n1. Go to login page\n2. Click login button\n3. Nothing happens","labels":["bug","frontend"]}'

Create feature request:

orth run github /create-issue -b '{"owner":"team","repo":"api","title":"Add user authentication","body":"We need JWT-based authentication for the API","labels":["enhancement"],"assignees":["developer1"]}'

List your repositories:

orth run github /list-repos -b '{"type":"owner","sort":"updated","per_page":10}'

Create pull request:

orth run github /create-pr -b '{"owner":"myorg","repo":"project","head":"fix/login-bug","base":"main","title":"Fix login validation bug","body":"Resolves #123\n\nFixed validation logic for email input field."}'

Create draft PR:

orth run github /create-pr -b '{"owner":"team","repo":"app","head":"feature/new-ui","base":"develop","title":"New UI components","draft":true}'

Star useful repository:

orth run github /star-repo -b '{"owner":"microsoft","repo":"vscode"}'

Error Handling

• HTTP 428 - GitHub integration not connected. Visit https://orthogonal.com/dashboard/integrations to connect your account
• 400 Bad Request - Invalid parameters or malformed request
• 401 Unauthorized - Invalid or expired GitHub token
• 403 Forbidden - Insufficient permissions for repository or action
• 404 Not Found - Repository, branch, or resource does not exist
• 409 Conflict - Pull request already exists for this branch combination
• 422 Unprocessable Entity - Validation failed (invalid labels, assignees, etc.)
• 429 Rate Limited - GitHub API rate limit exceeded

Tips

• Repository names are case-sensitive
• Use organization name as owner for organization repos
• Labels must already exist in the repository or be valid GitHub default labels
• Assignees must have repository access to be assigned to issues
• Pull request head/base branches must exist in the repository
• Draft PRs can be marked ready for review later
• Star repositories to bookmark them for later reference
• Use descriptive titles and detailed bodies for better collaboration
• Check repository permissions before creating issues or PRs