Github Stars

The GitHub Stars module allows you to automatically import your starred GitHub repositories into GoSuki as bookmarks. This ensures your favorite repositories are always accessible alongside your other bookmarks, searchable via the Web UI or CLI.

Requirements

To use the GitHub Stars module, you need a GitHub Personal Access Token (PAT) with the repo scope to access your starred repositories via the API.

Configuration

Enable the module by adding it to your config.toml file:

[[module]]
name = "github"
token = "ghp_your_token_here"
fetch_star_lists = true

Configuration Options

• token: Your GitHub Personal Access Token.
• fetch_star_lists: (Optional,
  gosuki+
  ) When set to true, GoSuki will also fetch repositories organized into your user-defined GitHub star lists.

Gosuki+ Enhancements

For Gosuki+ users, the GitHub module provides advanced capabilities to better organize and retrieve your curated lists:

• Star Lists Support: Instead of just a flat list of starred repositories, GoSuki+ can fetch your custom GitHub star lists.
• Full Pagination: Ensures that all repositories in your lists are imported, regardless of the size of your collection.
• Private List Support: Accesses and imports repositories from your private star lists, keeping your organized research accessible locally.

Tagging

Imported repositories are tagged automatically based on their source:

• Starred repositories — tagged with the repository’s GitHub topics (e.g., go, cli, devops).
• Star list items (
  gosuki+
  ) — tagged with the list’s name and the repository’s primary language (e.g., go, rust).