# @inaiii/pi-remote-extension

Pi extension for connecting local sessions to a configured Pi Remote Helper.

## Requirements

- [Pi](https://github.com/badlogic/pi-mono), currently tested with `0.81.1`.
- A running Pi Remote Helper. The supported installer currently targets macOS.

This package contains only the Extension. It does not install or configure the Pi Remote Helper, Server, or Browser application.

## Install

While the package is published under the `next` tag:

```bash
pi install npm:@inaiii/pi-remote-extension@next
```

Directly started Pi sessions remain disconnected by default. Enable the current Pi session explicitly:

```text
/remote-control
```

Use `/remote-control status` to inspect the current state and `/remote-control off` to revoke consent for that Pi session. Pi processes launched by the Pi Remote Helper connect automatically through their managed launch claim.

## Security

Pi extensions execute with the same system access as the Pi process. Review package contents before installation. Manual remote-control consent is stored in the current Pi session and does not grant the Browser or Helper arbitrary shell execution.

## Remove

```bash
pi remove npm:@inaiii/pi-remote-extension
```

## License

MIT