The recommended way to use this library is with git subtree into an asymworks folder under the current project, and reference it as a Project Library from KiCad.

git remote add -f asymworks-library https://git.asymworks.com/asymworks/kicad-library.git
git subtree add --prefix ./asymworks asymworks-library main --squash

Add the library to KiCad relative to the ${KIPRJMOD} variable.

Note

The Asymworks library currently has a mix of path specs for 3D models, most of which still use the legacy ${KICAD_USER_TEMPLATE_DIR}/asymworks-kicad-library root rather than ${KIPRJMOD}/asymworks. Manual intervention to change the path within pcbnew may be required for 3D models to show up correctly.

The library can be modified from the local project directory, and changes committed back to the main repository, using a similar syntax.

git add ./asymworks
git commit -m 'feat: added footprints XXXX'
git subtree push --prefix ./asymworks asymworks-library main

Warning

When using git subtree ensure that only changes within the subtree are added to a particular commit. Mixing files in a single commit between subtree and main project files may break things.

Useful Links

KiCad Library Conventions