git-tools
Public
Part of the LM Studio Agent Toolkit — five plugins for files and shell, memory, git, the web and documents. Install the others with lms get cervezagua/<plugin>.
Git and GitHub tools for LM Studio models: inspect changes, stage and commit, manage branches, and work with pull requests and issues through the GitHub CLI.
git on PATHgh auth login. The gh_* tools only appear when gh is installed.| Tool | Parameters | What it does |
|---|---|---|
git_status | – | Branch, upstream state, and changed/untracked files |
git_diff | staged?, ref?, path?, stat_only? | Unstaged changes by default; staged for what will be committed; ref to compare against a commit or branch |
git_log | count?, ref?, path? | Recent commits: hash, date, author, refs, subject (default 15) |
git_show | ref, stat_only? | A commit's message and changes |
git_add | paths | Stages files (["."] for everything), then shows the short status |
git_commit | message | Commits what's staged; refuses when nothing is staged. Multi-line messages are fine. |
git_branch |
| Setting | Default | Notes |
|---|---|---|
| Repository Directory | (empty = chat working directory) | Use the same folder as coder-tools' Root Directory. |
| Allow Push | off | Adds git_push. |
| Enable GitHub Tools | on | Adds the gh_* tools when gh is on PATH. |
| Max Output Characters | 20000 | Long diffs and logs are shortened from the middle. |
If memory-tools is enabled too, enter_plan_mode makes this plugin offer only the read-only git tools (git_status, git_diff, git_log, git_show and the gh_* viewers) until exit_plan_mode. See memory-tools' README.
git and gh are run directly, not through a shell, so text from the model can't inject other commands.- are rejected, so they can't be read as options (e.g. --output=...).git_commit fails with "Please tell me who you are", set your identity once in a terminal: git config --global user.name "..." and git config --global user.email "...".git_status → git_diff → git_add → → .Tests live in the repository root (npm test). The src/shared/ files are copied from the repository's shared/ folder; edit them there.
Part of the LM Studio Agent Toolkit — five plugins for files and shell, memory, git, the web and documents. Install the others with lms get cervezagua/<plugin>.
Git and GitHub tools for LM Studio models: inspect changes, stage and commit, manage branches, and work with pull requests and issues through the GitHub CLI.
git on PATHgh auth login. The gh_* tools only appear when gh is installed.| Tool | Parameters | What it does |
|---|---|---|
git_status | – | Branch, upstream state, and changed/untracked files |
git_diff | staged?, ref?, path?, stat_only? | Unstaged changes by default; staged for what will be committed; ref to compare against a commit or branch |
git_log | count?, ref?, path? | Recent commits: hash, date, author, refs, subject (default 15) |
git_show | ref, stat_only? | A commit's message and changes |
git_add | paths | Stages files (["."] for everything), then shows the short status |
git_commit | message | Commits what's staged; refuses when nothing is staged. Multi-line messages are fine. |
git_branch |
| Setting | Default | Notes |
|---|---|---|
| Repository Directory | (empty = chat working directory) | Use the same folder as coder-tools' Root Directory. |
| Allow Push | off | Adds git_push. |
| Enable GitHub Tools | on | Adds the gh_* tools when gh is on PATH. |
| Max Output Characters | 20000 | Long diffs and logs are shortened from the middle. |
If memory-tools is enabled too, enter_plan_mode makes this plugin offer only the read-only git tools (git_status, git_diff, git_log, git_show and the gh_* viewers) until exit_plan_mode. See memory-tools' README.
git and gh are run directly, not through a shell, so text from the model can't inject other commands.- are rejected, so they can't be read as options (e.g. --output=...).git_commit fails with "Please tell me who you are", set your identity once in a terminal: git config --global user.name "..." and git config --global user.email "...".git_status → git_diff → git_add → → .Tests live in the repository root (npm test). The src/shared/ files are copied from the repository's shared/ folder; edit them there.
name?, base?, switch? |
Lists branches, or creates/switches to name (optionally from base) |
git_init | – | Creates a repository in the Repository Directory |
git_push | remote? | Pushes the current branch and sets its upstream. Only present when Allow Push is on. Never force-pushes. |
gh_pr_list | state?, limit?, search? | Lists pull requests |
gh_pr_view | number? | A PR's description, status and comments (defaults to the current branch's PR) |
gh_pr_diff | number? | A PR's diff |
gh_pr_checks | number? | CI check results, including pending ones |
gh_pr_create | title, body, base?, draft? | Opens a PR from the current branch (push first) |
gh_issue_list | state?, limit?, search? | Lists issues |
gh_issue_view | number | An issue with its comments |
run_command; approve such calls carefully.git_diff staged=truegit_commitnpm install
lms dev
name?, base?, switch? |
Lists branches, or creates/switches to name (optionally from base) |
git_init | – | Creates a repository in the Repository Directory |
git_push | remote? | Pushes the current branch and sets its upstream. Only present when Allow Push is on. Never force-pushes. |
gh_pr_list | state?, limit?, search? | Lists pull requests |
gh_pr_view | number? | A PR's description, status and comments (defaults to the current branch's PR) |
gh_pr_diff | number? | A PR's diff |
gh_pr_checks | number? | CI check results, including pending ones |
gh_pr_create | title, body, base?, draft? | Opens a PR from the current branch (push first) |
gh_issue_list | state?, limit?, search? | Lists issues |
gh_issue_view | number | An issue with its comments |
run_command; approve such calls carefully.git_diff staged=truegit_commitnpm install
lms dev