Skip to content

Commit 6c5607d

Browse files
author
GAP Promoter
committed
Add jupyterjazz/git-agent to the registry
1 parent d65df87 commit 6c5607d

2 files changed

Lines changed: 53 additions & 0 deletions

File tree

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# git-agent
2+
3+
**git-agent** is a natural-language Git assistant built with [LangChain](https://github.com/langchain-ai/langchain) and OpenAI function calling. Instead of remembering Git commands, you just describe what you want to do — and the agent does it.
4+
5+
## What it does
6+
7+
Run `git-agent` from inside any local repository and pass a plain-English instruction as an argument. The agent reads the current repository state via `git status`, reasons about your intent, and executes the appropriate Git operation using one of its four tools:
8+
9+
| Tool | What it does |
10+
|---|---|
11+
| `git_status` | Inspects the working tree — automatically called for context before every instruction |
12+
| `git_diff` | Shows colourised diffs between the working directory and the last commit, scoped to specific files if requested |
13+
| `git_add` | Stages files for the next commit |
14+
| `git_restore` | Restores specified files to their last-committed state (discards local changes) |
15+
16+
## Example usage
17+
18+
```shell
19+
# Install
20+
pip install git+https://github.com/jupyterjazz/git-agent.git
21+
22+
# Set your OpenAI key
23+
export OPENAI_API_KEY=<your-key>
24+
25+
# Ask it something (run from inside a repo)
26+
git-agent "show me what changed in the authentication module"
27+
git-agent "stage only the files related to the login feature"
28+
git-agent "restore the config file to its last committed version"
29+
```
30+
31+
The agent maps your intent to the right Git command and executes it — colourising diff output (cyan for headers, red for deletions, green for additions) so it's easy to read at a glance.
32+
33+
## Model
34+
35+
Uses `gpt-3.5-turbo-0613` via OpenAI function calling (structured tool dispatch — no free-form shell execution).
36+
37+
## Compliance note
38+
39+
`git_restore` is a destructive, irreversible operation. The agent only restores files you explicitly ask about; it will not restore additional files unless you ask for all of them.
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"name": "git-agent",
3+
"author": "jupyterjazz",
4+
"description": "Natural-language Git agent using LangChain + OpenAI function calling — stage files, diff, and restore changes by plain English instructions.",
5+
"repository": "https://github.com/jupyterjazz/git-agent",
6+
"version": "1.0.0",
7+
"category": "developer-tools",
8+
"tags": ["git", "langchain", "openai", "natural-language", "cli", "developer-tools"],
9+
"license": "MIT",
10+
"model": "gpt-3.5-turbo-0613",
11+
"adapters": ["openai", "system-prompt"],
12+
"icon": false,
13+
"banner": false
14+
}

0 commit comments

Comments
 (0)