Searching and lists

Odyn has no central package registry. Instead you add package lists: git repositories that describe packages. You search across them.

What is a package list?

A package list is any git repository that publishes package metadata. Lists can be TOML, JSON, or even a plain README with a markdown table. You point Odyn at the lists you trust, and it reads them.

Add a list

odyn list add https://codeberg.org/user/awesome-packages

Or use a shorthand with --platform:

odyn list add user/awesome-packages -p codeberg

The list is cloned into a local cache and its packages become available for search.

Manage your lists

odyn list ls                    # show every added list
odyn list show <name>           # inspect a list's source and package count
odyn list update <name>         # re-fetch a single list
odyn list update                # refresh every list
odyn list rename <old> <new>    # give a list a new name
odyn list remove <name>         # delete a list and its cache

Search for packages

odyn search <query>

Returns every package whose name or repo slug matches your query across all added lists:

odyn search anima
odyn search --tag 2d --license MIT
odyn search physics -d collision

Filters narrow results without affecting ranking:

• -t, --tag filter by tag (repeatable).
• -l, --license filter by license (substring).
• -d, --in-description filter by description text.

Inspect a package

odyn info <name>
odyn info list:user/repo

Shows full details: repo URL, description, license, tags, and the install command.

Next steps

See the full command reference for every flag and argument.