Introduction to Punkt Hub
Discover how to download shared dotfiles and manage your configuration with Punkt Hub.
Register an Account
To commence your journey with Punkt Hub, you must first create an account:
punkt hub registerLog in to Your Account
Once registered, authenticate your session with the following command:
punkt hub loginView Your Profile
You may inspect your current profile details by running:
punkt hub whoamiPunkt Hub offers two tiers of service:
- Free
- Pro
Pro users enjoy the benefit of unlimited downloads from the Hub.
Activate your licence by running:
punkt hub activate-licence XXXX-XXXX-XXXX-XXXXBrowse Available Collections
Punkt Hub hosts a variety of dotfiles shared by the community. These are organised into collections, each containing a curated set of configuration files. You are free to browse and download these collections to customise your environment.
To list all public collections, execute the following:
punkt hub listTo view only your own collections, use the --mine flag:
punkt hub list --mineInspect a Collection
After listing the available collections, you may discover entries such as:
| Name | Description | Handle | Last Updated |
|---|---|---|---|
| Audrey's Collection | Audrey's favourites | 77 | 2025-01-01 |
To explore the contents of a specific collection, simply run the list command with its unique handle:
punkt hub list 77Synchronise a Collection
Should you find a collection that piques your interest, you may synchronise it to your Local State with the following command:
punkt hub sync 77Please remember to run punkt activate afterwards to apply the dotfiles from the collection.
Unsynchronise a Collection
If you no longer require a collection, you may easily remove it by running:
punkt hub unsync 77