github-ai-cli
v1.0.2
Published
AI-powered GitHub CLI using Gemini + MCP
Maintainers
Readme
GitHub AI CLI
AI-powered GitHub automation tool that lets you manage repositories using natural language.
Overview
GitHub AI CLI is a smart command-line tool that connects:
- GitHub API
- MCP (Model Context Protocol)
- Google Gemini AI
It allows you to perform GitHub operations using simple English commands instead of complex CLI commands.
Installation
$ npm install -g github-ai-cli
First Time Setup When you run the tool for the first time:
$ github-ai
You will be asked to enter:
- GitHub Username
- GitHub Personal Access Token
- Gemini API Key
These are stored locally in: $ ~/.github-ai-config.json
Features
- List your repositories
- create repo my-project
- delete repo username/repository-name
- Find empty repositories
AI Mode (Natural Language)
You can also use normal English:
- show all my repos
- create a repo called test-app
- delete repo Sushan1034/demo
The AI will automatically understand and execute the correct GitHub action.
Security All credentials are stored locally only No data is sent to external servers except GitHub & Gemini APIs No tracking or logging
How It Works
- User Command
- AI (Gemini) interprets intent
- MCP GitHub tools execute action
- Result returned to CLI
Requirements
- Node.js 18+
- GitHub Personal Access Token
- Gemini API Key
- Internet connection
Example Workflow github-ai
create repo ai-demo list my repositories empty repo delete repo me/test-repo
Powered By
- Google Gemini
- GitHub CLI (inspiration)
- MCP GitHub Server
Notes
- First run requires setup
- Credentials are stored locally on your machine
- Each user has their own configuration
Tip
If you ever want to reset setup:
- Change thorugh
nano ~/.github-ai-config.json
Or Delete this file:
del ~/.github-ai-config.json
3.Then run:
github-ai
