Skip to content
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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.

Argument Required Type 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.