# Holochain hc launch CLI
CLI to launch holochain apps in a sandboxed Holochain Launcher environment for testing and development purposes.
## Install
This CLI is part of the holochain development environment (holonix) and therein callable via `hc launch`.<br><br>
If you prefer to install it globally:
```
cargo install holochain_cli_launch
```
## Example Usage
* Launch a .webhapp with 2 agents communicating over mdns network and initializing lair-keystore "on-the-fly"
by piping a password through on the command line:
```bash
<br>
* Launch a .happ with the UI assets specified with the `--ui-path` option for 2 agents communicating over mdns network, initializing lair-keystore "on-the-fly"
by piping a password through on the command line and watching for file changes in the specified UI path:
```bash
<br>
* Launch a .happ while pointing to a port on localhost from where you serve the UI assets:<br>
**Note:** This mode is only meant for development purposes! Serving assets from localhost will result in different
behavior than running the app in the real Holochain Launcher.
```bash
echo pass | hc-launch --piped -n 2 path/to/my/app.happ --ui-port 5500 network mdns
```
<br>
## Documentation
Documentation is on https://docs.rs/holochain_cli_launch