Skip to content

Commit 05adea3

Browse files
authored
docs: add gitignore recommendations across all workflows (#198)
- Add .gitignore step to all setup instructions - Include `.gemini/` and `gha-creds-*.json` entries Note: Will update /setup-github command to handle gitignore automatically #196
1 parent 3653684 commit 05adea3

4 files changed

Lines changed: 66 additions & 6 deletions

File tree

README.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,9 @@ Use it to perform GitHub pull request reviews, triage issues, perform code analy
1212
- [Quick Start](#quick-start)
1313
- [1. Get a Gemini API Key](#1-get-a-gemini-api-key)
1414
- [2. Add it as a GitHub Secret](#2-add-it-as-a-github-secret)
15-
- [3. Choose a Workflow](#3-choose-a-workflow)
16-
- [4. Try it out!](#4-try-it-out)
15+
- [3. Update your .gitignore](#3-update-your-gitignore)
16+
- [4. Choose a Workflow](#4-choose-a-workflow)
17+
- [5. Try it out!](#5-try-it-out)
1718
- [Workflows](#workflows)
1819
- [Issue Triage](#issue-triage)
1920
- [Pull Request Review](#pull-request-review)
@@ -52,17 +53,28 @@ Store your API key as a secret named `GEMINI_API_KEY` in your repository:
5253
- Click **New repository secret**
5354
- Name: `GEMINI_API_KEY`, Value: your API key
5455

55-
### 3. Choose a Workflow
56+
### 3. Update your .gitignore
57+
Add the following entries to your `.gitignore` file:
58+
59+
```gitignore
60+
# gemini-cli settings
61+
.gemini/
62+
63+
# GitHub App credentials
64+
gha-creds-*.json
65+
```
66+
67+
### 4. Choose a Workflow
5668
You have two options to set up a workflow:
5769

5870
**Option A: Use setup command (Recommended)**
59-
1. Start the Gemini CLI:
71+
1. Start the Gemini CLI in your terminal:
6072

6173
```shell
6274
gemini
6375
```
6476

65-
2. In the chat interface, type:
77+
2. In Gemini CLI in your terminal, type:
6678

6779
```
6880
/setup-github
@@ -71,7 +83,7 @@ You have two options to set up a workflow:
7183
**Option B: Manually copy workflows**
7284
1. Copy the pre-built workflows from the [`examples/workflows`](./examples/workflows) directory to your repository's `.github/workflows` directory.
7385

74-
### 4. Try it out!
86+
### 5. Try it out!
7587

7688
**Pull Request Review:**
7789
- Open a pull request in your repository and wait for automatic review

examples/workflows/gemini-cli/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ In this guide you will learn how to use the Gemini CLI Assistant via GitHub Acti
66
- [Overview](#overview)
77
- [Features](#features)
88
- [Setup](#setup)
9+
- [Prerequisites](#prerequisites)
10+
- [Setup Methods](#setup-methods)
911
- [Usage](#usage)
1012
- [Supported Triggers](#supported-triggers)
1113
- [How to Invoke the Gemini CLI Workflow](#how-to-invoke-the-gemini-cli-workflow)
@@ -32,6 +34,20 @@ Unlike specialized Gemini CLI workflows for [pull request reviews](../pr-review)
3234

3335
For detailed setup instructions, including prerequisites and authentication, please refer to the main [Getting Started](../../../README.md#quick-start) section and [Authentication documentation](../../../docs/authentication.md).
3436

37+
### Prerequisites
38+
39+
Add the following entries to your `.gitignore` file to prevent Gemini CLI artifacts from being committed:
40+
41+
```gitignore
42+
# gemini-cli settings
43+
.gemini/
44+
45+
# GitHub App credentials
46+
gha-creds-*.json
47+
```
48+
49+
### Setup Methods
50+
3551
To use this workflow, you can utilize either of the following methods:
3652
1. Run the `/setup-github` command in Gemini CLI on your terminal to set up workflows for your repository.
3753
2. Copy the `gemini-cli.yml` file into your repository's `.github/workflows` directory:

examples/workflows/issue-triage/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ This document describes a comprehensive system for triaging GitHub issues using
66
- [Overview](#overview)
77
- [Features](#features)
88
- [Setup](#setup)
9+
- [Prerequisites](#prerequisites)
10+
- [Setup Methods](#setup-methods)
911
- [Usage](#usage)
1012
- [Supported Triggers](#supported-triggers)
1113
- [Real-Time Issue Triage](#real-time-issue-triage)
@@ -35,6 +37,20 @@ The Issue Triage workflows provide an automated system for analyzing and categor
3537

3638
For detailed setup instructions, including prerequisites and authentication, please refer to the main [Getting Started](../../../README.md#quick-start) section and [Authentication documentation](../../../docs/authentication.md).
3739

40+
### Prerequisites
41+
42+
Add the following entries to your `.gitignore` file to prevent issue triage artifacts from being committed:
43+
44+
```gitignore
45+
# gemini-cli settings
46+
.gemini/
47+
48+
# GitHub App credentials
49+
gha-creds-*.json
50+
```
51+
52+
### Setup Methods
53+
3854
To implement this issue triage system, you can utilize either of the following methods:
3955
1. Run the `/setup-github` command in Gemini CLI on your terminal to set up workflows for your repository.
4056
2. Copy the workflow files into your repository's `.github/workflows` directory:

examples/workflows/pr-review/README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@ This document explains how to use the Gemini CLI on GitHub to automatically revi
66
- [Overview](#overview)
77
- [Features](#features)
88
- [Setup](#setup)
9+
- [Prerequisites](#prerequisites)
10+
- [Setup Methods](#setup-methods)
911
- [Usage](#usage)
1012
- [Supported Triggers](#supported-triggers)
1113
- [Interaction Flow](#interaction-flow)
@@ -44,6 +46,20 @@ The PR Review workflow uses Google's Gemini AI to provide comprehensive code rev
4446

4547
For detailed setup instructions, including prerequisites and authentication, please refer to the main [Getting Started](../../../README.md#quick-start) section and [Authentication documentation](../../../docs/authentication.md).
4648

49+
### Prerequisites
50+
51+
Add the following entries to your `.gitignore` file to prevent PR review artifacts from being committed:
52+
53+
```gitignore
54+
# gemini-cli settings
55+
.gemini/
56+
57+
# GitHub App credentials
58+
gha-creds-*.json
59+
```
60+
61+
### Setup Methods
62+
4763
To use this workflow, you can use either of the following methods:
4864
1. Run the `/setup-github` command in Gemini CLI on your terminal to set up workflows for your repository.
4965
2. Copy the `gemini-pr-review.yml` file into your repository's `.github/workflows` directory:

0 commit comments

Comments
 (0)