Sandbox — LSD is in active testing. All systems operational·payments are test-mode (no real charges).
Overview Use Cases News Docs Tool Store Support Community Get LSD
All docs
Docs/ API Reference/ PackageManager/ add_local
PackageManager· method

PackageManager.add_local

register a package folder by reference (editable, no copy)

Python
add_local(source: str) -> Optional[PackageInfo]

Returns PackageInfo — the registered package, or None if it has no manifest

Parameters#

name type default description
source str — path to a package folder containing an lsd_package.json

Example#

Python
from lsdtools.advanced import PackageManager

pm = PackageManager()
pm.add_local("~/dev/my-pkg")   # stays in place; edits are live

Notes#

Unlike install (which copies into ~/.lsd/packages/), the folder stays where it is and its edits are picked up on the next reload. It is recorded with source="local" so it persists and loads again on the next launch. Returns None when the folder has no lsd_package.json. This is the desktop's "Add local package…" path — the authoring loop.

See also#

API: install · reload · remove

Guides: Develop a package · A complete package

By LSD Team · Last updated Jul 17, 2026 Ask on Discord View as Markdown