@slorenzot/git-plugin-opencode

Git tools plugin for OpenCode. Provides Git operations as tools for the AI agent.

Installation

From npm (once published)

Add to your opencode.json configuration:

{
  "plugin": ["@slorenzot/git-plugin-opencode"]
}

From GitHub

{
  "plugin": ["github:slorenzot/git-plugin-opencode"]
}

Or for global installation, add to ~/.config/opencode/opencode.json.

Available Tools

| Tool | Description | | -------------- | ----------------------------------------- | | git_branch | Get the current branch name | | git_branches | List all branches (local and remote) | | git_status | Show working tree status | | git_checkout | Switch branches or create new ones | | git_diff | Show changes between commits/working tree | | git_log | Show commit history | | git_commit | Create a new commit | | git_stash | Stash/unstash changes | | git_add | Stage files for commit | | git_reset | Unstage files or reset state | | git_pull | Fetch and merge from remote | | git_push | Push commits to remote | | git_fetch | Download objects from remote | | git_merge | Merge branches | | git_rebase | Reapply commits on another base | | git_remote | Manage remote repositories | | git_tag | Create, list, or delete tags | | git_show | Show commit/object details | | git_blame | Show line-by-line authorship |

Usage Examples

Once installed, the AI agent can use these tools automatically:

Check current branch:

"What branch am I on?"

View recent commits:

"Show me the last 5 commits"

Create a feature branch:

"Create a new branch called feature/login"

Stage and commit changes:

"Add all changes and commit with message 'Fix login bug'"

Push to remote:

"Push my changes to origin"

Development

# Install dependencies
npm install

# Type check
npm run typecheck

# Build
npm run build

Local Development

For local plugin development, you can use a file path:

{
  "plugin": ["file://.opencode/plugins/git.ts"]
}

License

MIT