opencode-gitloops 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const GitLoopsPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA+CjD,eAAO,MAAM,cAAc,EAAE,MA0E5B,CAAA"}

package/dist/index.js

@@ -0,0 +1,110 @@
+import { gitloops_clone, gitloops_refresh, gitloops_list } from "./tools";
+import { ensureRepo } from "./repo-manager";
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+const AGENT_MD = `---
+description: Explore GitHub repositories locally. Clone any public repo and answer questions about its code, structure, and patterns.
+mode: all
+color: "#4078c0"
+temperature: 0.1
+tools:
+  read: true
+  grep: true
+  glob: true
+  list: true
+  webfetch: false
+  bash: false
+  edit: false
+  write: false
+  gitloops_clone: true
+  gitloops_refresh: true
+  gitloops_list: true
+permission:
+  edit: deny
+  bash: deny
+---
+
+You are GitLoops, a read-only agent for exploring public GitHub repositories locally.
+
+When a user asks about a repository:
+1. Parse the repo slug from their message (e.g. "facebook/react" or a full GitHub URL)
+2. Call \`gitloops_clone\` with the slug to clone or refresh the repo and get its local path
+3. Use \`read\`, \`grep\`, \`glob\`, and \`list\` with absolute paths under the returned \`localPath\` to explore the code
+4. Call \`gitloops_refresh\` if the user explicitly wants the latest changes
+5. Call \`gitloops_list\` to show which repos are already cached locally
+
+Important rules:
+- You CANNOT modify any files. You are strictly read-only.
+- Always call \`gitloops_clone\` first before trying to read any files from a repo.
+- All file paths passed to read/grep/glob/list must be absolute paths under the repo's localPath.
+- When switching between repos in the same session, always call \`gitloops_clone\` again for the new repo.
+
+Repos are cached at: ~/.cache/gitloops/repos/<owner>/<repo>/
+`;
+export const GitLoopsPlugin = async ({ client }) => {
+    return {
+        // Write agent definition to global config on server connect (idempotent)
+        "server.connected": async () => {
+            try {
+                const agentsDir = path.join(os.homedir(), ".config", "opencode", "agents");
+                const agentPath = path.join(agentsDir, "gitloops.md");
+                await fs.mkdir(agentsDir, { recursive: true });
+                const existing = await fs
+                    .readFile(agentPath, "utf8")
+                    .catch(() => null);
+                if (existing !== AGENT_MD) {
+                    await fs.writeFile(agentPath, AGENT_MD, "utf8");
+                    await client.app.log({
+                        body: {
+                            service: "opencode-gitloops",
+                            level: "info",
+                            message: `Agent definition written to ${agentPath}`,
+                        },
+                    });
+                }
+            }
+            catch (err) {
+                await client.app.log({
+                    body: {
+                        service: "opencode-gitloops",
+                        level: "warn",
+                        message: `Failed to write agent definition: ${err.message || err}`,
+                    },
+                });
+            }
+        },
+        // Auto-fetch: when a gitloops session is created, pre-warm clone if a slug
+        // is detectable from the session title
+        event: async ({ event }) => {
+            if (event.type !== "session.created")
+                return;
+            try {
+                const session = event.properties;
+                if (!session || session.agentID !== "gitloops")
+                    return;
+                // Try to find a slug in the session title
+                const slugMatch = session.title?.match(/([a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+)/);
+                if (slugMatch) {
+                    await ensureRepo(slugMatch[1]);
+                    await client.app.log({
+                        body: {
+                            service: "opencode-gitloops",
+                            level: "info",
+                            message: `Pre-warmed repo: ${slugMatch[1]}`,
+                        },
+                    });
+                }
+            }
+            catch {
+                // Silent — agent will call gitloops_clone explicitly
+            }
+        },
+        tool: {
+            gitloops_clone,
+            gitloops_refresh,
+            gitloops_list,
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/repo-manager.d.ts

@@ -0,0 +1,44 @@
+export interface RepoInfo {
+    localPath: string;
+    slug: string;
+    owner: string;
+    repo: string;
+    lastCommit: string;
+    lastFetched: string;
+}
+export interface CachedRepo {
+    slug: string;
+    localPath: string;
+    lastModified: string;
+}
+export interface ParsedRepo {
+    owner: string;
+    repo: string;
+    cloneUrl: string;
+    slug: string;
+}
+/**
+ * Parse a repo slug or URL into its components.
+ *
+ * Accepts:
+ *   - "facebook/react"
+ *   - "https://github.com/facebook/react"
+ *   - "https://github.com/facebook/react.git"
+ *   - "git@github.com:facebook/react.git"
+ */
+export declare function parseRepoSlug(input: string): ParsedRepo;
+/**
+ * Get the local filesystem path where a repo is (or would be) cached.
+ */
+export declare function getLocalPath(slug: string): string;
+/**
+ * Clone a repo (or fetch latest if already cloned). Returns metadata about the repo.
+ *
+ * Respects GITLOOPS_FULL_CLONE env var — if truthy, clones without --depth=1.
+ */
+export declare function ensureRepo(input: string): Promise<RepoInfo>;
+/**
+ * List all repos currently cached under ~/.cache/gitloops/repos/.
+ */
+export declare function listCachedRepos(): Promise<CachedRepo[]>;
+//# sourceMappingURL=repo-manager.d.ts.map

package/dist/repo-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-manager.d.ts","sourceRoot":"","sources":["../src/repo-manager.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA8CvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AA0BD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoDjE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CA8C7D"}

package/dist/repo-manager.js

@@ -0,0 +1,181 @@
+import { $ } from "bun";
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+const CACHE_ROOT = path.join(os.homedir(), ".cache", "gitloops", "repos");
+/**
+ * Parse a repo slug or URL into its components.
+ *
+ * Accepts:
+ *   - "facebook/react"
+ *   - "https://github.com/facebook/react"
+ *   - "https://github.com/facebook/react.git"
+ *   - "git@github.com:facebook/react.git"
+ */
+export function parseRepoSlug(input) {
+    const trimmed = input.trim();
+    // Handle full HTTPS URLs
+    const httpsMatch = trimmed.match(/^https?:\/\/github\.com\/([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        const [, owner, repo] = httpsMatch;
+        return {
+            owner,
+            repo,
+            cloneUrl: `https://github.com/${owner}/${repo}.git`,
+            slug: `${owner}/${repo}`,
+        };
+    }
+    // Handle SSH URLs
+    const sshMatch = trimmed.match(/^git@github\.com:([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        const [, owner, repo] = sshMatch;
+        return {
+            owner,
+            repo,
+            cloneUrl: `https://github.com/${owner}/${repo}.git`,
+            slug: `${owner}/${repo}`,
+        };
+    }
+    // Handle owner/repo shorthand
+    const slugMatch = trimmed.match(/^([a-zA-Z0-9_.-]+)\/([a-zA-Z0-9_.-]+)$/);
+    if (slugMatch) {
+        const [, owner, repo] = slugMatch;
+        return {
+            owner,
+            repo,
+            cloneUrl: `https://github.com/${owner}/${repo}.git`,
+            slug: `${owner}/${repo}`,
+        };
+    }
+    throw new Error(`Invalid repo identifier: "${input}". Expected "owner/repo", a GitHub HTTPS URL, or an SSH URL.`);
+}
+/**
+ * Get the local filesystem path where a repo is (or would be) cached.
+ */
+export function getLocalPath(slug) {
+    const { owner, repo } = parseRepoSlug(slug);
+    return path.join(CACHE_ROOT, owner, repo);
+}
+/**
+ * Check if a directory exists.
+ */
+async function dirExists(dirPath) {
+    try {
+        const stat = await fs.stat(dirPath);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the latest commit hash from a local repo.
+ */
+async function getLastCommit(repoPath) {
+    try {
+        const result = await $ `git -C ${repoPath} rev-parse --short HEAD`.text();
+        return result.trim();
+    }
+    catch {
+        return "unknown";
+    }
+}
+/**
+ * Clone a repo (or fetch latest if already cloned). Returns metadata about the repo.
+ *
+ * Respects GITLOOPS_FULL_CLONE env var — if truthy, clones without --depth=1.
+ */
+export async function ensureRepo(input) {
+    const parsed = parseRepoSlug(input);
+    const localPath = path.join(CACHE_ROOT, parsed.owner, parsed.repo);
+    const fullClone = process.env.GITLOOPS_FULL_CLONE === "true";
+    const depthArgs = fullClone ? [] : ["--depth=1"];
+    if (await dirExists(path.join(localPath, ".git"))) {
+        // Repo already cloned — fetch latest
+        try {
+            if (fullClone) {
+                await $ `git -C ${localPath} fetch origin`.quiet();
+            }
+            else {
+                await $ `git -C ${localPath} fetch --depth=1 origin`.quiet();
+            }
+            await $ `git -C ${localPath} reset --hard origin/HEAD`.quiet();
+        }
+        catch (err) {
+            throw new Error(`Failed to fetch updates for ${parsed.slug}: ${err.message || err}`);
+        }
+    }
+    else {
+        // Fresh clone
+        await fs.mkdir(path.dirname(localPath), { recursive: true });
+        try {
+            await $ `git clone ${depthArgs} ${parsed.cloneUrl} ${localPath}`.quiet();
+        }
+        catch (err) {
+            // Clean up partial clone on failure
+            await fs.rm(localPath, { recursive: true, force: true }).catch(() => { });
+            if (String(err).includes("not found") ||
+                String(err).includes("Repository not found")) {
+                throw new Error(`Repository "${parsed.slug}" not found on GitHub. Only public repos are supported in v1.`);
+            }
+            throw new Error(`Failed to clone ${parsed.slug}: ${err.message || err}`);
+        }
+    }
+    const lastCommit = await getLastCommit(localPath);
+    return {
+        localPath,
+        slug: parsed.slug,
+        owner: parsed.owner,
+        repo: parsed.repo,
+        lastCommit,
+        lastFetched: new Date().toISOString(),
+    };
+}
+/**
+ * List all repos currently cached under ~/.cache/gitloops/repos/.
+ */
+export async function listCachedRepos() {
+    const repos = [];
+    if (!(await dirExists(CACHE_ROOT))) {
+        return repos;
+    }
+    let owners;
+    try {
+        owners = await fs.readdir(CACHE_ROOT);
+    }
+    catch {
+        return repos;
+    }
+    for (const owner of owners) {
+        const ownerPath = path.join(CACHE_ROOT, owner);
+        if (!(await dirExists(ownerPath)))
+            continue;
+        let repoNames;
+        try {
+            repoNames = await fs.readdir(ownerPath);
+        }
+        catch {
+            continue;
+        }
+        for (const repo of repoNames) {
+            const repoPath = path.join(ownerPath, repo);
+            if (!(await dirExists(path.join(repoPath, ".git"))))
+                continue;
+            let lastModified;
+            try {
+                const stat = await fs.stat(repoPath);
+                lastModified = stat.mtime.toISOString();
+            }
+            catch {
+                lastModified = "unknown";
+            }
+            repos.push({
+                slug: `${owner}/${repo}`,
+                localPath: repoPath,
+                lastModified,
+            });
+        }
+    }
+    return repos;
+}
+//# sourceMappingURL=repo-manager.js.map

package/dist/repo-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-manager.js","sourceRoot":"","sources":["../src/repo-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AAwBxB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;AAEzE;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAE5B,yBAAyB;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAC9B,2EAA2E,CAC5E,CAAA;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,UAAU,CAAA;QAClC,OAAO;YACL,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,sBAAsB,KAAK,IAAI,IAAI,MAAM;YACnD,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;SACzB,CAAA;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAC5B,mEAAmE,CACpE,CAAA;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAA;QAChC,OAAO;YACL,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,sBAAsB,KAAK,IAAI,IAAI,MAAM;YACnD,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;SACzB,CAAA;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACzE,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,SAAS,CAAA;QACjC,OAAO;YACL,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,sBAAsB,KAAK,IAAI,IAAI,MAAM;YACnD,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;SACzB,CAAA;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,8DAA8D,CACjG,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACnC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAA,UAAU,QAAQ,yBAAyB,CAAC,IAAI,EAAE,CAAA;QACxE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,CAAA;IAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAEhD,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAClD,qCAAqC;QACrC,IAAI,CAAC;YACH,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,CAAA,UAAU,SAAS,eAAe,CAAC,KAAK,EAAE,CAAA;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAA,UAAU,SAAS,yBAAyB,CAAC,KAAK,EAAE,CAAA;YAC7D,CAAC;YACD,MAAM,CAAC,CAAA,UAAU,SAAS,2BAA2B,CAAC,KAAK,EAAE,CAAA;QAC/D,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CACpE,CAAA;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,cAAc;QACd,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5D,IAAI,CAAC;YACH,MAAM,CAAC,CAAA,aAAa,SAAS,IAAI,MAAM,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC,KAAK,EAAE,CAAA;QACzE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,oCAAoC;YACpC,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACxE,IACE,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAC5C,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,IAAI,+DAA+D,CAC1F,CAAA;YACH,CAAC;YACD,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CACxD,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAA;IAEjD,OAAO;QACL,SAAS;QACT,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU;QACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,KAAK,GAAiB,EAAE,CAAA;IAE9B,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,MAAgB,CAAA;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;QAC9C,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;YAAE,SAAQ;QAE3C,IAAI,SAAmB,CAAA;QACvB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAC3C,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;gBAAE,SAAQ;YAE7D,IAAI,YAAoB,CAAA;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACpC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,SAAS,CAAA;YAC1B,CAAC;YAED,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;gBACxB,SAAS,EAAE,QAAQ;gBACnB,YAAY;aACb,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,26 @@
+export declare const gitloops_clone: {
+    description: string;
+    args: {
+        repo: import("zod").ZodString;
+        branch: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    execute(args: {
+        repo: string;
+        branch?: string | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const gitloops_refresh: {
+    description: string;
+    args: {
+        repo: import("zod").ZodString;
+    };
+    execute(args: {
+        repo: string;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const gitloops_list: {
+    description: string;
+    args: {};
+    execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc;;;;;;;;;;CA0CzB,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;CAmB3B,CAAA;AAEF,eAAO,MAAM,aAAa;;;;CAiBxB,CAAA"}

package/dist/tools.js

@@ -0,0 +1,71 @@
+import { tool } from "@opencode-ai/plugin";
+import { ensureRepo, listCachedRepos } from "./repo-manager";
+export const gitloops_clone = tool({
+    description: "Clone or ensure a GitHub repo is available locally for exploration. " +
+        "Returns the local filesystem path to use with read/grep/glob/list tools. " +
+        "Accepts 'owner/repo' shorthand or a full GitHub URL.",
+    args: {
+        repo: tool.schema
+            .string()
+            .describe("Repo identifier — e.g. 'facebook/react' or 'https://github.com/facebook/react'"),
+        branch: tool.schema
+            .string()
+            .optional()
+            .describe("Branch to checkout after cloning (default: repo default branch)"),
+    },
+    async execute(args) {
+        const info = await ensureRepo(args.repo);
+        // If a specific branch was requested, check it out
+        if (args.branch) {
+            const { $ } = await import("bun");
+            try {
+                await $ `git -C ${info.localPath} fetch origin ${args.branch}`.quiet();
+                await $ `git -C ${info.localPath} checkout ${args.branch}`.quiet();
+                await $ `git -C ${info.localPath} reset --hard origin/${args.branch}`.quiet();
+            }
+            catch (err) {
+                throw new Error(`Failed to checkout branch "${args.branch}" for ${info.slug}: ${err.message || err}`);
+            }
+        }
+        return [
+            `Repository: ${info.slug}`,
+            `Local path: ${info.localPath}`,
+            `Last commit: ${info.lastCommit}`,
+            `Last fetched: ${info.lastFetched}`,
+            ``,
+            `Use this path with read, grep, glob, and list tools to explore the repo.`,
+        ].join("\n");
+    },
+});
+export const gitloops_refresh = tool({
+    description: "Force-fetch the latest changes for a previously cloned GitHub repo. " +
+        "Use this when the user wants the most up-to-date code.",
+    args: {
+        repo: tool.schema
+            .string()
+            .describe("Repo identifier — e.g. 'facebook/react'"),
+    },
+    async execute(args) {
+        const info = await ensureRepo(args.repo);
+        return [
+            `Refreshed: ${info.slug}`,
+            `Local path: ${info.localPath}`,
+            `Last commit: ${info.lastCommit}`,
+            `Fetched at: ${info.lastFetched}`,
+        ].join("\n");
+    },
+});
+export const gitloops_list = tool({
+    description: "List all GitHub repos currently cached locally by gitloops. " +
+        "Shows slug, local path, and last modified time for each cached repo.",
+    args: {},
+    async execute() {
+        const repos = await listCachedRepos();
+        if (repos.length === 0) {
+            return "No repos cached. Use gitloops_clone to clone a repo first.";
+        }
+        const lines = repos.map((r) => `${r.slug}  ${r.localPath}  (modified: ${r.lastModified})`);
+        return [`Cached repos (${repos.length}):`, "", ...lines].join("\n");
+    },
+});
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;IACjC,WAAW,EACT,sEAAsE;QACtE,2EAA2E;QAC3E,sDAAsD;IACxD,IAAI,EAAE;QACJ,IAAI,EAAE,IAAI,CAAC,MAAM;aACd,MAAM,EAAE;aACR,QAAQ,CACP,gFAAgF,CACjF;QACH,MAAM,EAAE,IAAI,CAAC,MAAM;aAChB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,iEAAiE,CAAC;KAC/E;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAExC,mDAAmD;QACnD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,CAAA,UAAU,IAAI,CAAC,SAAS,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAA;gBACrE,MAAM,CAAC,CAAA,UAAU,IAAI,CAAC,SAAS,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAA;gBACjE,MAAM,CAAC,CAAA,UAAU,IAAI,CAAC,SAAS,wBAAwB,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAA;YAC9E,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,GAAG,EAAE,CACrF,CAAA;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,eAAe,IAAI,CAAC,IAAI,EAAE;YAC1B,eAAe,IAAI,CAAC,SAAS,EAAE;YAC/B,gBAAgB,IAAI,CAAC,UAAU,EAAE;YACjC,iBAAiB,IAAI,CAAC,WAAW,EAAE;YACnC,EAAE;YACF,0EAA0E;SAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;IACnC,WAAW,EACT,sEAAsE;QACtE,wDAAwD;IAC1D,IAAI,EAAE;QACJ,IAAI,EAAE,IAAI,CAAC,MAAM;aACd,MAAM,EAAE;aACR,QAAQ,CAAC,yCAAyC,CAAC;KACvD;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAExC,OAAO;YACL,cAAc,IAAI,CAAC,IAAI,EAAE;YACzB,eAAe,IAAI,CAAC,SAAS,EAAE;YAC/B,gBAAgB,IAAI,CAAC,UAAU,EAAE;YACjC,eAAe,IAAI,CAAC,WAAW,EAAE;SAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;IAChC,WAAW,EACT,8DAA8D;QAC9D,sEAAsE;IACxE,IAAI,EAAE,EAAE;IACR,KAAK,CAAC,OAAO;QACX,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAA;QAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,4DAA4D,CAAA;QACrE,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,gBAAgB,CAAC,CAAC,YAAY,GAAG,CAClE,CAAA;QACD,OAAO,CAAC,iBAAiB,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrE,CAAC;CACF,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "opencode-gitloops",
+  "version": "0.1.0",
+  "description": "GitHub repo explorer agent and plugin for OpenCode. Clone and explore any public GitHub repo locally.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "github",
+    "git",
+    "explorer",
+    "gitloops"
+  ],
+  "scripts": {
+    "build": "bun run tsc",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "latest"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.5.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/maharshi-me/gitloops"
+  },
+  "author": "",
+  "engines": {
+    "node": ">=18"
+  }
+}