Gitloops

A plugin for OpenCode that lets you clone and explore GitHub repositories locally. Ask questions about a repo's code, structure, and patterns — all without leaving your terminal.

Gitloops provides three custom tools (gitloops_clone, gitloops_refresh, gitloops_list) restricted to read operations — no file modifications, no shell access. You can use these tools from any agent, or optionally enable a dedicated gitloops agent via config.

Installation

Add the plugin to your opencode.json config file:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-gitloops"]
}

OpenCode will automatically install the package.

Alternatively, you can install it as a local plugin by placing it in your plugin directory:

• Project-level: .opencode/plugins/
• Global: ~/.config/opencode/plugins/

Configuration

Gitloops auto-creates a config file on first load at:

~/.config/opencode/plugin/gitloops.json

{
  "$schema": "https://raw.githubusercontent.com/maharshi365/opencode-gitloops/master/schema/config.schema.json",
  "max_repos": 10,
  "cache_loc": "~/.cache/gitloops/repos",
  "eviction_strategy": "lru",
  "agent": {
    "enabled": false,
    "model": "anthropic/claude-sonnet-4-5",
    "temperature": 0.1,
    "color": "#ed5f00",
    "mode": "all"
  }
}

Option	Type	Default	Description
max_repos	integer	10	Maximum number of cached repos. When exceeded, repos are evicted automatically.
cache_loc	string	~/.cache/gitloops/repos	Directory where cloned repos are stored (<cache_loc>/<owner>/<repo>/). Supports ~.
eviction_strategy	string	"lru"	Strategy for removing repos when max_repos is exceeded.
agent	object	see below	Controls the optional dedicated gitloops agent.

Eviction strategies

Strategy	Behavior
lru	Remove the least recently used repo (oldest modification time)
fifo	Remove the oldest cloned repo (oldest creation time)
largest	Remove the largest repo by disk size

Agent configuration

The agent object controls the optional dedicated gitloops agent entry in OpenCode. By default (enabled: false) only the plugin tools are registered — you can call them from any agent or the default assistant.

Field	Type	Default	Description
enabled	boolean	false	Set to true to add a gitloops entry to the OpenCode agent picker.
model	string	(session)	Model to use, e.g. "anthropic/claude-sonnet-4-5". Falls back to the session model if omitted.
temperature	number	0.1	Sampling temperature (0–2).
color	string	"#ed5f00"	Hex color (e.g. "#FF5733") or theme color name ("primary", "accent", etc.) shown in the UI.
mode	string	"all"	"primary" — main picker only. "subagent" — @mention only. "all" — both.

The $schema field enables autocompletion and validation in editors that support JSON Schema.

Private repositories

Private repositories are supported as long as your local git credentials or SSH keys grant access — the same way git clone works in your terminal. No additional configuration is needed.

If a clone fails due to missing credentials, Gitloops will surface a specific error message directing you to configure your git credentials or SSH keys.