pi-gh-my-starred

内容来源：SKILL.md（标准 Skill 格式） · 原始地址 · 查看安装指南

原始内容

---
name: gh-my-starred
description: GitHub CLI extension for browsing starred repositories with AI-accessible JSON output
change_log:
  - timestamp: 2026-05-06T15:00:00Z
    agent_id: "pi-agent"
    note: "Added add_to_star_list tool to mutate user star lists and documented required user scope."
  - timestamp: 2026-05-05T14:30:00Z
    agent_id: "pi-agent"
    note: "Fixed pi session crashes by adding missing sqlite3 dependency, handling async sqlite exceptions properly, and correctly serializing embedding float arrays."
  - timestamp: 2026-04-26T21:55:00Z
    agent_id: "pi-agent"
    note: "Updated pagination logic in fetchStarredRepos to cache all repos and apply limit only to returned results."
  - timestamp: 2026-04-26T23:50:00Z
    agent_id: "pi-agent"
    note: "Added progressive enhancement recommendation to leverage pi-librarian for repo review."
---

# gh-my-starred

Browse and query your GitHub starred repositories interactively or programmatically.

## Metadata

- **Source**: https://github.com/kylebrodeur/gh-my-starred
- **NPM**: https://www.npmjs.com/package/pi-gh-my-starred
- **License**: MIT
- **Tags**: `github`, `cli`, `fzf`, `stars`, `repositories`, `search`, `pi-package`, `pi-extension`

## Installation

### Terminal CLI

```bash
gh extension install kylebrodeur/gh-my-starred
```

### PI Package (AI tools)

```bash
pi install npm:pi-gh-my-starred
```

### Both (Recommended)

```bash
gh extension install kylebrodeur/gh-my-starred
pi install npm:pi-gh-my-starred
```

## Usage

### Interactive Mode
```bash
gh my-starred
gh my-starred 100
```

### JSON Mode
```bash
gh my-starred --json
gh my-starred --json 50
```

### Star Lists
```bash
gh my-starred --lists
gh my-starred --list "Favorites"
gh my-starred --list "Research" --json
```

## PI Tools

| Tool | Description |
|------|-------------|
| `starred_repos` | Query and filter starred repositories |
| `list_star_lists` | Discover all star lists |
| `get_list_repos` | Get ordered repos from a specific list |
| `compare_lists` | Compare two star lists |
| `add_to_star_list` | Add repositories to a star list |

## Permissions

Some features (like `add_to_star_list`) require the ability to mutate user lists. If you encounter an `INSUFFICIENT_SCOPES` error, you must grant the `user` scope to your GitHub CLI:

```bash
gh auth refresh -s user
```

## Updating

### CLI
```bash
gh extension upgrade kylebrodeur/gh-my-starred
```

### PI Package
```bash
pi update
```

### Both
```bash
gh extension upgrade kylebrodeur/gh-my-starred
pi update
/reload
```

## JSON Schema

| Field | Type | Description |
|-------|------|-------------|
| `full_name` | string | "owner/repo" format |
| `description` | string | Repository description |
| `stargazers_count` | integer | Number of stars |
| `language` | string | Primary language |
| `html_url` | string | Repository URL |
| `topics` | string[] | Topic tags |
| `updated_at` | string | ISO 8601 timestamp |

## Requirements

- GitHub CLI (`gh`) authenticated
- `fzf` for interactive mode
- `jq` recommended for JSON queries

## Uninstall

### CLI
```bash
gh extension remove kylebrodeur/gh-my-starred
```

### PI Package
```bash
pi remove npm:pi-gh-my-starred
```

## Notes

- PI tools (`starred_repos`, etc.) work **standalone** via `gh api`
- `/starred` PI command requires both CLI + PI package installed
- Terminal and PI installs are independent — no conflicts or duplicates

## 🚀 Progressive Enhancements

When reviewing repos discovered via `gh-my-starred`, agents can leverage **`pi-librarian`** as a powerful alternative or supplement to the `gh` CLI. While `gh` is excellent for metadata and high-level status, `pi-librarian` enables targeted reconnaissance, deep code-path discovery, and evidence-based research directly within the project's codebase without needing to clone every repo.

name: gh-my-starred description: GitHub CLI extension for browsing starred repositories with AI-accessible JSON output change_log:

timestamp: 2026-05-06T15:00:00Z agent_id: "pi-agent" note: "Added add_to_star_list tool to mutate user star lists and documented required user scope."
timestamp: 2026-05-05T14:30:00Z agent_id: "pi-agent" note: "Fixed pi session crashes by adding missing sqlite3 dependency, handling async sqlite exceptions properly, and correctly serializing embedding float arrays."
timestamp: 2026-04-26T21:55:00Z agent_id: "pi-agent" note: "Updated pagination logic in fetchStarredRepos to cache all repos and apply limit only to returned results."
timestamp: 2026-04-26T23:50:00Z agent_id: "pi-agent" note: "Added progressive enhancement recommendation to leverage pi-librarian for repo review."

gh-my-starred

Browse and query your GitHub starred repositories interactively or programmatically.

Metadata

Source: https://github.com/kylebrodeur/gh-my-starred
NPM: https://www.npmjs.com/package/pi-gh-my-starred
License: MIT
Tags: github, cli, fzf, stars, repositories, search, pi-package, pi-extension

Installation

Terminal CLI

gh extension install kylebrodeur/gh-my-starred

PI Package (AI tools)

pi install npm:pi-gh-my-starred

Both (Recommended)

gh extension install kylebrodeur/gh-my-starred
pi install npm:pi-gh-my-starred

Usage

Interactive Mode

gh my-starred
gh my-starred 100

JSON Mode

gh my-starred --json
gh my-starred --json 50

Star Lists

gh my-starred --lists
gh my-starred --list "Favorites"
gh my-starred --list "Research" --json

PI Tools

Tool	Description
`starred_repos`	Query and filter starred repositories
`list_star_lists`	Discover all star lists
`get_list_repos`	Get ordered repos from a specific list
`compare_lists`	Compare two star lists
`add_to_star_list`	Add repositories to a star list

Permissions

Some features (like add_to_star_list) require the ability to mutate user lists. If you encounter an INSUFFICIENT_SCOPES error, you must grant the user scope to your GitHub CLI:

gh auth refresh -s user

Updating

CLI

gh extension upgrade kylebrodeur/gh-my-starred

PI Package

pi update

Both

gh extension upgrade kylebrodeur/gh-my-starred
pi update
/reload

JSON Schema

Field	Type	Description
`full_name`	string	"owner/repo" format
`description`	string	Repository description
`stargazers_count`	integer	Number of stars
`language`	string	Primary language
`html_url`	string	Repository URL
`topics`	string[]	Topic tags
`updated_at`	string	ISO 8601 timestamp

Requirements

GitHub CLI (gh) authenticated
fzf for interactive mode
jq recommended for JSON queries

Uninstall

CLI

gh extension remove kylebrodeur/gh-my-starred

PI Package

pi remove npm:pi-gh-my-starred

Notes

PI tools (starred_repos, etc.) work standalone via gh api
/starred PI command requires both CLI + PI package installed
Terminal and PI installs are independent — no conflicts or duplicates

🚀 Progressive Enhancements

When reviewing repos discovered via gh-my-starred, agents can leverage pi-librarian as a powerful alternative or supplement to the gh CLI. While gh is excellent for metadata and high-level status, pi-librarian enables targeted reconnaissance, deep code-path discovery, and evidence-based research directly within the project's codebase without needing to clone every repo.