@prinova/pi-github-tools

GitHub repository tools extension for pi-coding-agent. Provides tools to read, search, and explore GitHub repositories directly from pi.

Installation

pi install npm:@prinova/pi-github-tools

Or install globally:

npm install -g @prinova/pi-github-tools

Setup

This extension requires a GitHub Personal Access Token (PAT) to access the GitHub API. Set the GITHUB_PAT environment variable:

export GITHUB_PAT=ghp_your_token_here

To create a token:

1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Click "Generate new token (classic)"
3. Select the repo scope for full repository access, or public_repo for public repositories only
4. Generate and copy the token

Tools

This extension adds the following tools to pi:

read_github

Read the contents of a file from a GitHub repository.

Parameters:

• path - The file path within the repository (e.g., "src/index.ts")
• repository - The repository URL (e.g., "https://github.com/owner/repo")
• startLine (optional) - Start line number to read from (1-indexed)
• endLine (optional) - End line number to read to (1-indexed)

Example:

{ "path": "README.md", "repository": "https://github.com/facebook/react" }

list_directory_github

List the contents of a directory in a GitHub repository.

Parameters:

• path - Directory path (use "." for root)
• repository - Repository URL

Example:

{ "path": "src", "repository": "https://github.com/facebook/react" }

search_github

Search for code patterns in a GitHub repository using GitHub's code search API.

Parameters:

• pattern - Search query pattern (GitHub code search syntax)
• repository - Repository URL to search within
• path (optional) - Subdirectory path to limit search

Example:

{ "pattern": "function useState", "repository": "https://github.com/facebook/react" }

glob_github

Find files matching a glob pattern in a GitHub repository using the Git tree API.

Parameters:

• filePattern - Glob pattern to match (e.g., "/*.md", "src//*.ts")
• repository - Repository URL
• limit (optional) - Maximum results to return
• offset (optional) - Offset for pagination

Example:

{ "filePattern": "**/*.test.ts", "repository": "https://github.com/facebook/react" }

list_repositories

Search and list public GitHub repositories.

Parameters:

• pattern (optional) - Search term to match in repository names
• organization (optional) - Organization to search within
• language (optional) - Programming language filter
• limit (optional) - Max results (default: 30)

Example:

{ "pattern": "react", "limit": 10 }

commit_search

Search commits in a GitHub repository.

Parameters:

• repository - Repository URL (required)
• query (optional) - Search term in commit messages
• author (optional) - GitHub username of commit author
• since (optional) - Start date (YYYY-MM-DD)
• until (optional) - End date (YYYY-MM-DD)

Example:

{ "repository": "https://github.com/facebook/react", "query": "fix hooks", "author": "danabramov" }

Usage in pi

Once installed, the tools are automatically available in pi. Just ask pi to use them:

Read the README from https://github.com/vercel/next.js

Find all TypeScript files in the React repository

Search for "useEffect" usage in the facebook/react repo

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.