# @kkskcs/pi-open

Open files with the default app, or open your current directory in finder, terminal, or a split pane — instantly from pi.

## Installation

```bash
pi install npm:@kkskcs/pi-open
```

## /open \<path\>

Opens a file or directory with the OS default application.

```
/open ./README.md
/open assets/
```

- Files open in the associated default app
- Directories open in the system file manager (Finder, Nautilus, Explorer)
- Shows an error if the path does not exist

| Platform | Command |
|----------|---------|
| macOS | `open` |
| Linux | `xdg-open` |
| Windows | `start` |

### Usage with pi-fff

When used with [@ff-labs/pi-fff](https://www.npmjs.com/package/@ff-labs/pi-fff), you can use @-mention autocomplete to search and select files:

```
/open @src/index.ts
/open @package.json
```

The `@` prefix is automatically stripped if the literal path is not found.

## /open-cwd

Opens the current session working directory in another app.

```
/open-cwd
```

![open-cwd](https://raw.githubusercontent.com/kkskcs/pi-lego/develop/packages/pi-open/assets/open-cwd.png)

Runs as a command, so there's no AI response to wait for. No terminal-specific shortcuts to memorize — just pick an action, done. Works with Ghostty, WezTerm, iTerm2, kitty, tmux, and more — one unified interface regardless of which terminal you're in.

### Features

- **Split pane** — split the current terminal in a given direction
- **New terminal** — open a new terminal window at cwd
- **Finder / File manager** — reveal cwd in the system file manager
- **Fuzzy filter** — type to narrow down actions
- Unsupported actions are hidden from the list (no dead options)

### Supported Terminals

#### macOS

| Terminal       | Detection                      | Split                      | Directions               | New Window                        |
|----------------|--------------------------------|----------------------------|--------------------------|-----------------------------------|
| Ghostty        | `$TERM_PROGRAM=ghostty`        | ✓ AppleScript              | up / down / left / right | ✓ AppleScript                     |
| WezTerm        | `$TERM_PROGRAM=WezTerm`        | ✓ `wezterm cli split-pane` | up / down / left / right | ✓ `wezterm cli spawn`             |
| tmux           | `$TMUX`                        | ✓ `tmux split-window`      | up / down / left / right | ✓ `tmux new-window`               |
| iTerm2         | `$TERM_PROGRAM=iTerm.app`      | ✓ AppleScript              | down / right             | ✓ `open -a iTerm`                 |
| kitty          | `$TERM_PROGRAM=kitty`          | ✓ `kitty @`                | down / right             | ✓ `kitty --directory`             |
| Alacritty      | `$TERM_PROGRAM=alacritty`      | —                          | —                        | ✓ `alacritty --working-directory` |
| Apple Terminal | `$TERM_PROGRAM=Apple_Terminal` | —                          | —                        | ✓ `open -a Terminal`              |
| Warp           | `$TERM_PROGRAM=WarpTerminal`   | —                          | —                        | ✓ `open -a Warp`                  |

Finder: `open <cwd>`

#### Linux

| Terminal  | Detection               | Split                      | Directions               | New Window                        |
|-----------|-------------------------|----------------------------|--------------------------|-----------------------------------|
| WezTerm   | `$TERM_PROGRAM=WezTerm` | ✓ `wezterm cli split-pane` | up / down / left / right | ✓ `wezterm cli spawn`             |
| tmux      | `$TMUX`                 | ✓ `tmux split-window`      | up / down / left / right | ✓ `tmux new-window`               |
| kitty     | `$TERM=xterm-kitty`     | ✓ `kitty @`                | down / right             | ✓ `kitty --directory`             |
| Ghostty   | `$TERM_PROGRAM=ghostty` | —                          | —                        | ✓ `ghostty --working-directory`   |
| Alacritty | `$TERM=alacritty`       | —                          | —                        | ✓ `alacritty --working-directory` |

File manager: `xdg-open <cwd>`

#### Windows

| Terminal         | Detection                 | Split                      | Directions               | New Window                        |
|------------------|---------------------------|----------------------------|--------------------------|-----------------------------------|
| WezTerm          | `$TERM_PROGRAM=WezTerm`   | ✓ `wezterm cli split-pane` | up / down / left / right | ✓ `wezterm cli spawn`             |
| Windows Terminal | `$WT_SESSION`             | ✓ `wt sp`                  | down / right             | ✓ `wt -w 0 -d`                    |
| Alacritty        | `$TERM_PROGRAM=alacritty` | —                          | —                        | ✓ `alacritty --working-directory` |

Explorer: `explorer <cwd>`

### Detection Priority

1. `$TMUX` → tmux
2. `$WT_SESSION` → Windows Terminal
3. `$TERM_PROGRAM` → corresponding terminal
4. `$TERM` → fallback (kitty, alacritty)

## Development

```bash
cd packages/pi-open
pnpm install
pnpm run build
```