Documentation menu

Git and GitHub

On this page

Review revisions and connection status before sending or bringing in repository changes.

Use these tools

  1. Call the relevant read or status tool first.
  2. Review the target and required arguments.
  3. Run one intended action, with explicit human confirmation where required.
  4. Inspect status or re-read the affected resource afterward.

Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.

git_status

The project’s git status and GitHub connection.

Read the returned resource and use its current values when planning the next action.

ArgumentRequiredType or accepted values

| projectId | No | string |

Operation: read-only.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

git_history

The project’s latest commits.

Read the returned resource and use its current values when planning the next action.

ArgumentRequiredType or accepted values

| projectId | No | string |

Operation: read-only.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

git_commit

Commit the project’s changes.

Records source revisions. Inspect git_status and supply a message that describes the change.

ArgumentRequiredType or accepted values

| projectId | No | string |

| message | Yes | string; minLength 1; maxLength 200 |

Operation: can change state or start work.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

git_discard

Throw away uncommitted changes.

Destructive: throws away uncommitted changes. Inspect status and preserve wanted work before confirming.

ArgumentRequiredType or accepted values

| projectId | No | string |

| confirm | Yes | boolean |

Operation: can change state or start work; destructive effects are possible.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

git_revert

Go back to an earlier commit.

Changes the source revision. Review the specified commit and current work before confirming.

ArgumentRequiredType or accepted values

| projectId | No | string |

| hash | Yes | string |

| confirm | Yes | boolean |

Operation: can change state or start work; destructive effects are possible.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

connect_github

Connect the project to GitHub.

Returns the supported browser authorization flow. A person must complete it; an agent cannot approve GitHub consent.

ArgumentRequiredType or accepted values

| projectId | No | string |

Operation: can change state or start work.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

publish_to_github

Publish the project to a GitHub repository.

Review owner, destination and visibility. Repository publication makes source available according to that visibility.

ArgumentRequiredType or accepted values

| projectId | No | string |

| repoName | No | string; minLength 1; maxLength 100 |

| private | No | boolean |

| owner | No | string; minLength 1; maxLength 100 |

| repo | No | string; minLength 1; maxLength 100 |

Operation: can change state or start work.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

github_sync

Push to or pull from GitHub.

direction chooses push or pull. Coordinate outstanding changes and review conflicts rather than repeatedly retrying.

ArgumentRequiredType or accepted values

| projectId | No | string |

| direction | Yes | push, pull |

Operation: can change state or start work.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

disconnect_github

Disconnect the project from GitHub.

Removes the project connection after confirmation. Does not delete the remote repository.

ArgumentRequiredType or accepted values

| projectId | No | string |

| confirm | Yes | boolean |

Operation: can change state or start work; destructive effects are possible.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

github_repositories

The user’s GitHub repositories and branches.

Read the returned resource and use its current values when planning the next action.

ArgumentRequiredType or accepted values

| projectId | No | string |

| owner | No | string; minLength 1; maxLength 100 |

| repo | No | string; minLength 1; maxLength 100 |

| page | No | integer; minimum 1; maximum 1000 |

| search | No | string; maxLength 200 |

Operation: read-only.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

Record the repository a project was imported from.

Records the imported repository relationship. Verify owner, repository and branch; this is not a full application conversion by itself.

ArgumentRequiredType or accepted values

| projectId | No | string |

| owner | Yes | string; minLength 1; maxLength 100 |

| repo | Yes | string; minLength 1; maxLength 100 |

| branch | No | string; minLength 1; maxLength 200 |

Operation: can change state or start work.

Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The machine-readable tool contracts include nested argument schemas.

MCP home · Recovery workflow · Costs

Names and marks

GitHub and GitHub Copilot are brands of GitHub, Inc. Usage policy.

Go names and any associated marks remain with their respective owners or project maintainers. References identify products, standards or source examples. OwlMeans documentation does not imply sponsorship or endorsement by those owners.