An open API service indexing awesome lists of open source software.

https://github.com/sgoedecke/gh-standup

A GitHub CLI extension for generating an AI-assisted standup report
https://github.com/sgoedecke/gh-standup

ai cli gh-extension github-cli standup-report

Last synced: about 2 months ago
JSON representation

A GitHub CLI extension for generating an AI-assisted standup report

Awesome Lists containing this project

README

          

# gh-standup

A GitHub CLI extension that generates AI-powered standup reports using GitHub activity data. It uses free [GitHub Models](https://docs.github.com/en/github-models) for inference, so you don't need to do any token setup - your existing GitHub CLI token will do fine!

## Installation

```bash
gh extension install sgoedecke/gh-standup
gh standup
```

### Organizations

To ensure the GitHub CLI can access your organization's data:

```bash
# Authenticate with GitHub CLI (if not already done)
gh auth login

# Authenticate with your organizations
gh auth refresh -h github.com -s read:org
```

### Prerequisites

- [GitHub CLI](https://cli.github.com/) installed and authenticated

## Usage

### Basic Usage

Generate a standup report for yesterday's activity:

```bash
gh standup
```

### Advanced Options

```bash
# Look back multiple days
gh standup --days 3

# Generate report for specific user
gh standup --user octocat

# Generate report for specific repository
gh standup --repo owner/repo

# Use a different AI model
gh standup --model xai/grok-3-mini
```

## Contributing

Contributions are welcome. In particular, I encourage tweaking of the [prompt](https://github.com/sgoedecke/gh-standup/blob/main/internal/llm/standup.prompt.yml). Since I've extracted it into a file, you should be able to fork the repo and iterate on the prompt via the GitHub Models UI:

`https://github.com/[your-username]/gh-standup/models/prompt/compare/main/internal/llm/standup.prompt.yml`