# Pane commands (/docs/v0.4/cli/panes)



Inside koshi, omitted targets use the current session, tab, pane, or client.
Outside koshi, pass a target unless exactly one running session can be chosen.

<Callout>
  These verbs take `--remote <SERVER>` to act on a session on another machine.
  See [Remote commands](/docs/v0.4/cli/remote).
</Callout>

## `new-pane` [#new-pane]

Open a shell pane:

```bash
koshi new-pane
koshi new-pane --direction left
koshi new-pane --stacked
```

Main flags:

| Flag                                | Meaning                              |
| ----------------------------------- | ------------------------------------ |
| `--direction right\|down\|left\|up` | Place the new pane beside its target |
| `--stacked`                         | Add it to the target's stack         |
| `--pane <PANE_ID>`                  | Split this pane                      |
| `--tab <NAME_OR_ID>`                | Create inside this tab               |
| `--session <NAME_OR_ID>`            | Choose the session                   |
| `--client <CLIENT_ID>`              | Use this client's current view       |

`--direction` and `--stacked` are alternatives. The command prints one pane id.

A new pane's working directory and environment come from the terminal that
issued the command.

## `run` [#run]

Open a pane running one command:

```bash
koshi run -- htop
koshi run --direction down -- cargo watch -x test
```

Placement flags match `new-pane`. Everything after `--` is the command and its
arguments. The command prints one pane id.

## `close-pane` [#close-pane]

```bash
koshi close-pane
koshi close-pane --pane <PANE_ID>
koshi close-pane --pane <PANE_ID> --force
```

Closing the last pane closes its tab. `--force` skips the normal close guard.

## `resize-pane` [#resize-pane]

```bash
koshi resize-pane --direction right
koshi resize-pane --direction left --size 4 --pane <PANE_ID>
koshi resize-pane --direction right --size -2
```

Directions are `right`, `down`, `left`, and `up`. A positive size grows toward
that direction; a negative size shrinks from that side.

## `focus-pane` [#focus-pane]

```bash
koshi focus-pane --pane <PANE_ID>
koshi focus-pane --pane <PANE_ID> --client <CLIENT_ID>
```

Focus belongs to a client. `--client` chooses which attached terminal moves.

## `toggle-pane-fullscreen` [#toggle-pane-fullscreen]

```bash
koshi toggle-pane-fullscreen
```

Fill the current tab with its focused pane, or restore the prior layout. The
fullscreen view belongs to one client.

## `input` [#input]

```bash
koshi input --pane <PANE_ID> "cargo test"
koshi input --pane <PANE_ID> --no-enter "git status"
```

Text is followed by Enter unless `--no-enter` is present. Input reaches only
panes visible to the issuing client.