# `NervesHubLink.Extensions.LocalShell`
[🔗](https://github.com/nerves-hub/nerves_hub_link/blob/v2.12.0/lib/nerves_hub_link/extensions/local_shell/local_shell.ex#L6)

Provides an interactive local shell for NervesHub to connect to.

This extension supports the following events:

- `request_shell`: Requests a shell session.
- `kill_shell`: Kills the current shell session. (the default signal is 15 - SIGTERM)
- `shell_input`: Sends input to the shell session.
- `window_size`: Updates the window size of the shell session.

To use this extension, you need to include the [`ExPTY`](https://hex.pm/packages/expty) library in your project's dependencies.

---

*Consult [api-reference.md](api-reference.md) for complete listing*