CLI reference

heph run

Run a command

heph run <TARGET_ADDRESS>
heph run <LABEL> <PACKAGE_MATCHER>

Flag	Value	Default	Description
<ARG1>	TARGET_ADDRESS/LABEL		Target address (e.g., //pkg:name) OR Label
<ARG2>	PACKAGE_MATCHER		Package matcher (only if first argument is a Label)
--force			Force execution
--shell	TARGET		Interactive shell
--cat-out			Print output artifacts to stdout
--list-out			Print output file list to stdout
-e, --exclude	TARGET_ADDRESS		Exclude target address (repeatable, e.g. -e //pkg:target)

heph inspect

Inspect

heph inspect [COMMAND]

heph inspect packages

List packages

heph inspect packages [MATCHER]

Flag	Value	Default	Description
<MATCHER>	MATCHER		Packages matcher

heph inspect hashin

Prints targets hashin

heph inspect hashin <ADDR>

Flag	Value	Default	Description
<ADDR>	ADDR		Target address

heph inspect hashout

Prints targets hashout

heph inspect hashout <ADDR>

Flag	Value	Default	Description
<ADDR>	ADDR		Target address

heph inspect spec

Prints target spec

heph inspect spec <ADDR>

Flag	Value	Default	Description
<ADDR>	ADDR		Target address

heph inspect def

Prints target def

heph inspect def [OPTIONS] <ADDR>

Flag	Value	Default	Description
<ADDR>	ADDR		Target address
--no-transitive			Skip applying transitive deps

heph inspect deps

Prints target deps

heph inspect deps [OPTIONS] <ADDR>

Flag	Value	Default	Description
<ADDR>	ADDR		Target address
-i, --interactive			Explore deps interactively

heph inspect functions

List provider-exposed functions (heph.<provider>.<fn>)

heph inspect functions

heph query

Query targets

heph query <TARGET_ADDRESS>
heph query <LABEL> <PACKAGE_MATCHER>

Flag	Value	Default	Description
<ARG1>	TARGET_ADDRESS/LABEL		Target address (e.g., //pkg:name) OR Label
<ARG2>	PACKAGE_MATCHER		Package matcher (only if first argument is a Label)
-e, --exclude	TARGET_ADDRESS		Exclude target address (repeatable, e.g. -e //pkg:target)

heph version

Prints version

heph version

heph gc

Garbage collect the local cache

heph gc