--- id: CoWork-OS/CoWork-OS/pi-finder-subagent version: "fb804eaa" license: MIT install: manual updated: 2026-07-27 --- # pi-finder-subagent — Pi-finder-subagent scans your local repository to pinpoint relevant files and code snippets, helping you narrow context before coding. It outputs a cited shortlist with line ranges and saves a focused report to guide your next steps. Publisher: CoWork-OS · Stars: 406 · Updated: 2026-07-27 Install (manual): `git clone https://github.com/CoWork-OS/CoWork-OS` ## Decision gist - What it does: Pi-finder-subagent scouts your local workspace to identify relevant files and snippets before you start coding. - Install: `npx skillfed install CoWork-OS/CoWork-OS/pi-finder-subagent` · manual: `git clone https://github.com/CoWork-OS/CoWork-OS` → `cp -r CoWork-OS/resources/skills/pi-finder-subagent ~/.claude/skills/pi-finder-subagent` - Use it when: Pi-finder-subagent produces an actionable file shortlist with citations and line ranges for each match. - Use it when: Yes. - Similar skills: CoWork-OS/CoWork-OS/pi-librarian, CoWork-OS/CoWork-OS/pi-context-pipeline, CoWork-OS/CoWork-OS/llm-wiki - Verify: Read SKILL.md below before installing ## SKILL.md # Pi-finder-subagent ## Purpose Read-only local workspace scout subagent for Pi. Use it to narrow context to relevant files/snippets before implementation. ## Routing - Use when: Use when users ask to scout the local repository, identify relevant files/snippets, or reduce context before coding. - Do not use when: Do not use for remote GitHub-first research across external repositories; use pi-librarian instead. - Outputs: A cited local-file shortlist with line ranges plus a saved report at {artifactDir}/finder-report.md. - Success criteria: Finder completes with concrete file paths, line ranges, and focused next steps that reduce implementation context. ## Trigger Examples ### Positive - Use the pi-finder-subagent skill for this request. - Help me with pi-finder-subagent. - Use when users ask to scout the local repository, identify relevant files/snippets, or reduce context before coding. - Pi-finder-subagent: provide an actionable result. ### Negative - Do not use for remote GitHub-first research across external repositories; use pi-librarian instead. - Do not use pi-finder-subagent for unrelated requests. - This request is outside pi-finder-subagent scope. - This is conceptual discussion only; no tool workflow is needed. ## Parameters | Name | Type | Required | Description | |---|---|---|---| | query | string | Yes | What to find in the local workspace | | scope_hint | string | No | Optional directories/files/symbols to prioritize | ## Runtime Prompt - Current runtime prompt length: 775 characters. - Runtime prompt is defined directly in `../pi-finder-subagent.json`. [View on SkillFed](https://skillfed.io/CoWork-OS/CoWork-OS/pi-finder-subagent) · [View on GitHub](https://github.com/CoWork-OS/CoWork-OS)