@touchtechclub/pi-oc-repo-research

Opencode-inspired Pi extension providing git repository cloning and overview tools for agent research.

Features

• repo_clone — Clone any git repository into a managed local cache, with optional refresh and branch selection
• repo_overview — Inspect a cached or local repository's structure, detect ecosystems, dependency files, and entrypoints

Install

Local linking (development)

# In pi-toolkit root:
bun install

Then add to .pi/settings.json:

{
  "packages": ["../packages/oc-repo-research"]
}

From npm

pi extension add @touchtechclub/pi-oc-repo-research

Configuration

| Variable | Description | Default | |---|---|---| | OPENCODE_REPO_CLONE_GITHUB_BASE_URL | Override GitHub clone base URL | https://github.com/ |

Tools

repo_clone

Clones a git repository into a managed local cache directory (~/.pi/agent/repos/). Supports GitHub owner/repo shorthand, full URLs, and SCP-style references.

| Parameter | Type | Description | |---|---|---| | repository | string | Repository to clone (URL, host/path, or owner/repo shorthand) | | refresh | boolean? | When true, fetches latest remote state into cache | | branch | string? | Branch or ref to clone and inspect |

repo_overview

Inspects the directory structure of a cloned or local repository. Detects language ecosystems, package managers, dependency files, and likely entrypoints.

| Parameter | Type | Description | |---|---|---| | repository | string? | Cached repository to inspect (use repo_clone first) | | path | string? | Directory path to inspect instead of a cached repository | | depth | number? | Maximum directory tree depth (default: 3, range: 1–6) |

License

MIT