# Why my shards no search result in shardbox or shards.info? **URL:** \ **Category:** Help & Support\ **Created:** [May 9, 2026, 11:32am UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934 "2026-05-09T11:32:21Z")\ **Posts on this page:** 12\ **Page:** 1
**Author:** ![zw963](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/zw963/32/1623_2.png) [@zw963](https://forum.crystal-lang.org/u/zw963)\ **Post date:** [May 9, 2026, 11:32am UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/1 "2026-05-09T11:32:21Z")
I have this question after I saw the [5 Years Anniversary](https://forum.crystal-lang.org/t/5-years-anniversary-of-crystal-1-0/8801) video, Because of the decentralized nature of Crystal shards, I don’t actually use them very often. However, I am curious just as an example, why my shards, such as [procodile](https://github.com/crystal-china/procodile), as a long-standing Crystal project (it’s been around for years in github), aren’t showing up in the search results on either of these sites? ---
**Author:** ![kojix2](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/kojix2/32/1583_2.png) [@kojix2](https://forum.crystal-lang.org/u/kojix2)\ **Post date:** [May 9, 2026, 12:27pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/2 "2026-05-09T12:27:56Z")
My understanding is that Shardbox does not add projects automatically. You need to open a [pull request](https://github.com/shardbox/catalog/pulls?q=is%3Apr+is%3Aclosed) to request inclusion. I’m not sure about shards.info, but my guess is that it filters out forked repositories as non-original projects. Otherwise, all forked repositories would appear on the site. ---
**Author:** ![zw963](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/zw963/32/1623_2.png) [@zw963](https://forum.crystal-lang.org/u/zw963)\ **Post date:** [May 9, 2026, 12:38pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/3 "2026-05-09T12:38:04Z")
Let’s ask the authors to get a more definitive answer. @straight-shoota @mamantoha > You need to open a [pull request](https://github.com/shardbox/catalog/pulls?q=is%3Apr+is%3Aclosed) to request inclusion If that’s really what’s required, it’s way too cumbersome. From my perspective, it’s just not feasible, we need a more simpler(or automated) way to handle this. ---
**Author:** ![kojix2](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/kojix2/32/1583_2.png) [@kojix2](https://forum.crystal-lang.org/u/kojix2)\ **Post date:** [May 9, 2026, 1:03pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/4 "2026-05-09T13:03:31Z")
> [@zw963](#): > > From my perspective, it’s just not feasible, we need a more simpler(or automated) way to handle this. Since I started using agent coding, even when I publish a library, I no longer want it to be widely used as much as before. Other people can probably generate something similar with agents, and I want to avoid extra maintenance work or responsibility. Some people may also prefer quieter places than GitHub. A complete catalog of shards is useful. But I also think a database where authors or others can request registration only when they want to is a good idea. ---
**Author:** ![ysbaddaden](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/ysbaddaden/32/2252_2.png) [@ysbaddaden](https://forum.crystal-lang.org/u/ysbaddaden)\ **Post date:** [May 9, 2026, 2:18pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/5 "2026-05-09T14:18:09Z")
> If that’s really what’s required, it’s way too cumbersome. Spending a few minutes to list your shards is _nothing_ compared to spending years maintaining 'em. Look at [https://shards.info/](https://shards.info/) for a blunt “whatever uses crystal language” but that only tracks [github.com](http://github.com), while shards could come from wherever (gitlab, codeberg, custom gitea server, …) ---
**Author:** ![zw963](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/zw963/32/1623_2.png) [@zw963](https://forum.crystal-lang.org/u/zw963)\ **Post date:** [May 9, 2026, 4:14pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/6 "2026-05-09T16:14:59Z")
I feel like [shardbox.org](http://shardbox.org) is still too clunky. Since there’s already a website, a simple web form would be more than enough. > Spending a few minutes to list your shards is _nothing_ compared to spending years maintaining 'em. I maintain this project because I genuinely enjoy it and because it’s useful to me. It feels completely different from just writing a YAML file, forking a repo, and submitting a PR. Not to mention, I don’t like handling such trivial requests. Besides, what if the other person doesn’t even have a GitHub account? Even if they do, what if there’s already a `catalog` project with the same name? These are all valid concerns. and, there are still open issues regarding the addition or removal of shards. (Translated from Chinese using gemma4:26b) ---
**Author:** ![straight-shoota](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/straight-shoota/32/36_2.png) [@straight-shoota](https://forum.crystal-lang.org/u/straight-shoota)\ **Post date:** [May 9, 2026, 4:58pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/7 "2026-05-09T16:58:14Z")
> [@zw963](#): > > I feel like [shardbox.org](http://shardbox.org) is still too clunky. Since there’s already a website, a simple web form would be more than enough. I agree that adding shards to the index requires jumping through more hoops than should be necessary. But it’s actually quite a huge leap from “there is already a website” to “receive HTTP submissions to edit the catalog”. The current website is entirely read-only, except for a private webhook that triggers a resync of the catalog data. Adding a web form would require a lot of security work to ensure only valid submissions are allowed. Going through the Github PR workflow is clunky, but it was an easy grab. It works well enough in my opinion, as it takes care of authorization, editorial workflow, synchronization, and accountability. So I don’t see an urgent need to work on a replacement. But I’m happy to talk about alternatives. Contributions to improve the workflow are welcome, of course. > [@zw963](#): > > Even if they do, what if there’s already a `catalog` project with the same name? Naming conflicts are a general problem for the ecosystem, regardless of whether the conflicting shards are indexed on shardbox. Shardbox itself handles multiple shards with the same name just fine because it identifies shards by repo. In case of ambiguity, the name-based short identifier gets an additional qualifier representing the owner of the shard. ---
**Author:** ![zw963](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/zw963/32/1623_2.png) [@zw963](https://forum.crystal-lang.org/u/zw963)\ **Post date:** [May 9, 2026, 5:31pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/8 "2026-05-09T17:31:06Z")
Anyway, adding a simple form would be extremely easy. 1. Select an existing category from the list. 2. Enter the GitHub URL of the shard. 3. Provide a description. After submission, it will remain in a “pending” state until you manually verify it on the backend. Besides, since the submission already includes the user’s Git repo, everything remains fully traceable. In short, this is a very straightforward process and won’t add much complexity. If you think this sounds okay, shall I go ahead and try to implement it? (Translated from Chinese using gemma4:26b) ---
**Author:** ![paulocoghi](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/paulocoghi/32/1429_2.png) [@paulocoghi](https://forum.crystal-lang.org/u/paulocoghi)\ **Post date:** [May 9, 2026, 6:23pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/9 "2026-05-09T18:23:22Z")
In my opinion it is more than acceptable the publishing procedure through a PR in [github.com/shardbox/catalog](https://github.com/shardbox/catalog). Maintaining a package registry is a heavy work because of the constant maintenance, security, etc. What I personally understand is that most devs here have the the necessary knowledge (and more) to create and maintain a package registry for Crystal, but the challenge is not knowledge, it is time. ---
**Author:** ![kojix2](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/kojix2/32/1583_2.png) [@kojix2](https://forum.crystal-lang.org/u/kojix2)\ **Post date:** [May 9, 2026, 11:22pm UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/10 "2026-05-09T23:22:57Z")
Personally, I think editing the catalog file directly with GitHub’s file editor is easier than submitting a form. But a clear guide or entry point could still help. ![image](https://canada1.discourse-cdn.com/flex036/uploads/crystal_lang/original/2X/e/e298e43a57f7970144772d0bd58f6805486a31eb.png) ---
**Author:** ![dengolius](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/dengolius/32/1920_2.png) [@dengolius](https://forum.crystal-lang.org/u/dengolius)\ **Post date:** [May 13, 2026, 7:33am UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/11 "2026-05-13T07:33:05Z")
IMHO: GitHub Actions or a relevant bash script are more stable than using an agent for a simple task, because agents can do unexpected things or not do anything due to a lack of tokens. ---
**Author:** ![kojix2](https://yyz2.discourse-cdn.com/flex036/user_avatar/forum.crystal-lang.org/kojix2/32/1583_2.png) [@kojix2](https://forum.crystal-lang.org/u/kojix2)\ **Post date:** [May 13, 2026, 8:09am UTC](https://forum.crystal-lang.org/t/why-my-shards-no-search-result-in-shardbox-or-shards-info/8934/12 "2026-05-13T08:09:41Z")
Just to clarify, are you talking about some near-future agent-assisted workflow where an LLM reads a human-written submission, decides something like “this shard seems worth listing” or “this one probably doesn’t need to be listed,” and then tries to update the catalog by running git commands, sometimes successfully and sometimes not? Sorry if my wording was confusing. That was not what I meant, but the idea is interesting in its own way 😅