Skip to main content
GitHub tools wrap local git and the GitHub CLI (gh) so agents can branch, commit, push, and open pull requests from a repo checkout. 
from praisonaiagents import Agent
from praisonaiagents.tools import (
    github_create_branch,
    github_commit_and_push,
    github_create_pull_request,
)

agent = Agent(
    name="GitHub Release Agent",
    instructions="Create a branch, commit staged work, and open a pull request.",
    tools=[github_create_branch, github_commit_and_push, github_create_pull_request],
)

agent.start(
    "Create branch 'feature/auth', commit with message 'Add JWT auth', "
    "then open a PR titled 'Add user authentication feature' targeting main."
)
Prerequisites: git installed with the working directory inside a repository (github_create_branch, github_commit_and_push); origin remote configured for push; gh CLI installed and authenticated via gh auth login (github_create_pull_request).

​
Quick Start

1

Import tools

from praisonaiagents import Agent
from praisonaiagents.tools import (
    github_create_branch,
    github_commit_and_push,
    github_create_pull_request,
)
2

Attach to an agent

agent = Agent(
    name="GitHub Agent",
    tools=[github_create_branch, github_commit_and_push, github_create_pull_request],
)

​
How It Works

​
Tools

​
github_create_branch(branch_name: str) -> str

Creates and checks out a new branch (git checkout -B).
ParameterTypeDescription
branch_namestrBranch to create and check out
Returns a success message or an error string.

​
github_commit_and_push(commit_message: str) -> str

Stages all changes, commits, and pushes to origin on the current branch.
ParameterTypeDescription
commit_messagestrCommit message
Returns a success message, "No changes to commit.", or an error string.

​
github_create_pull_request(title, body, head_branch, base_branch="main") -> str

Creates a pull request via gh pr create.
ParameterTypeDefaultDescription
titlestr—PR title in the GitHub UI — descriptive and concise
bodystr—PR description (markdown, issue refs such as #123)
head_branchstr—Source branch with your changes
base_branchstr"main"Target branch (main, master, develop, …)
github_create_pull_request(
    title="Add user authentication feature",
    body="Implements secure login with JWT tokens\n\nFixes #123",
    head_branch="feature/auth",
    base_branch="main",
)
# -> 'Successfully created Pull Request:\nhttps://github.com/user/repo/pull/456'
Returns a success message with the PR URL, or an error if gh is missing or unauthenticated.

​
Common patterns

github_create_branch("feature/docs-update")
github_commit_and_push("docs: update README")
github_create_pull_request(
    title="Update README",
    body="Clarifies setup steps.",
    head_branch="feature/docs-update",
)

​
Best practices

Run gh auth login before agents call github_create_pull_request. The tool checks gh auth status first.
github_commit_and_push stages all changes (git add .). Review the working tree before the agent commits.
Include what changed, why, and linked issues — the body field supports markdown.
Tools return error strings rather than raising — check return values in hooks if you need hard failures.

Linear Bot

Example workflow using GitHub tools

Shell Tools

Similar CLI-wrapping tools