Skip to main content
Query your GitHub repository information without AI interpretation.

​
Usage

clanker github <subcommand> [flags]

​
Configuration

Configure GitHub repositories in ~/.clanker.yaml: 
github:
  token: "ghp_..."              # GitHub personal access token
  default_repo: infrastructure   # Default repository
  repos:
    - owner: your-username
      repo: infrastructure
      description: Infrastructure repository
    - owner: your-username
      repo: services
      description: Services and database schemas
The GitHub token is optional for public repositories but required for private repos and higher rate limits.

​
Subcommands

​
list

List GitHub resources. 
clanker github list <resource-type> [flags]
Resource types:
  • repos - Configured GitHub repositories
  • workflows - GitHub Actions workflows
  • runs - Recent workflow runs
  • prs - Recent pull requests
Flags:
​
--repo
string
Repository name (uses default if not specified)
​
--owner
string
Repository owner/organization

​
Examples

# List configured repos
clanker github list repos

# List workflows
clanker github list workflows --repo infrastructure

# List recent workflow runs
clanker github list runs --repo services

# List pull requests
clanker github list prs --repo infrastructure

​
status

Check GitHub Actions workflow status. 
clanker github status [flags]
Flags:
​
--repo
string
Repository name
​
--owner
string
Repository owner
​
--workflow
string
Specific workflow name or ID

​
Examples

# Check all workflow statuses
clanker github status --repo infrastructure

# Check specific workflow
clanker github status --repo services --workflow "CI/CD"

​
Integration with ask command

For natural language queries about GitHub, use the ask command: 
# AI-powered GitHub queries
clanker ask --github "What's the status of CI workflows?"
clanker ask --github "Show me failed workflow runs"
clanker ask --github "List open pull requests"
See the GitHub integration guide for more details.

​
Output format

By default, commands output human-readable tables. For JSON output: 
clanker github list workflows --repo infrastructure --format json

GitHub integration

Learn about GitHub integration features

Ask command

Natural language GitHub queries

Configuration

Configure GitHub repositories

Build docs developers (and LLMs) love

Get started for freeTalk to us