# Tab commands (/docs/v0.1/cli/tabs)



## `new-tab` [#new-tab]

```bash
koshi new-tab
koshi new-tab --session <NAME_OR_ID>
```

Creates one tab with one shell pane. Output contains the tab id first, then the
root pane id.

## `close-tab` [#close-tab]

```bash
koshi close-tab
koshi close-tab --tab <NAME_OR_ID>
koshi close-tab --tab <NAME_OR_ID> --session <NAME_OR_ID> --force
```

Closing a tab closes every pane and process inside it. `--force` skips the
normal close guard.

## Cycle tabs [#cycle-tabs]

```bash
koshi next-tab
koshi previous-tab
koshi next-tab --client <CLIENT_ID>
```

Cycling changes one client's view. `--client` chooses the attached terminal.

## Focus one tab [#focus-one-tab]

```bash
koshi focus-tab --index 0
koshi focus-tab --tab <TAB_ID>
koshi focus-tab --tab <TAB_ID> --client <CLIENT_ID>
```

`--index` is zero-based. Use either `--index` or `--tab`.

## Reorder [#reorder]

```bash
koshi move-tab --index 0
koshi move-tab --tab <TAB_ID> --index 2
```

Moves the chosen tab to a zero-based index without changing its pane layout.