# Quick start (/docs/v0.1/quick-start)



## Open a session [#open-a-session]

```bash
koshi
```

That gives you one tab with one shell pane. The bar at the top lists tabs; the
bar at the bottom shows key hints once a shortcut is pending.

## Split a pane [#split-a-pane]

The default leader is <kbd>Ctrl</kbd>. Press the leader chord, then the
direction:

| Keys                           | Result                                  |
| ------------------------------ | --------------------------------------- |
| <kbd>\<C-p></kbd> <kbd>l</kbd> | Open a pane to the right                |
| <kbd>\<C-p></kbd> <kbd>h</kbd> | Open a pane to the left                 |
| <kbd>\<C-p></kbd> <kbd>j</kbd> | Open a pane below                       |
| <kbd>\<C-p></kbd> <kbd>k</kbd> | Open a pane above                       |
| <kbd>\<C-p></kbd> <kbd>n</kbd> | Open a pane in the configured direction |

A new pane inherits the working directory of the pane you split from.

## Move around and resize [#move-around-and-resize]

| Keys                              | Result                                       |
| --------------------------------- | -------------------------------------------- |
| <kbd>\<C-p></kbd> <kbd>←↓↑→</kbd> | Focus a nearby pane                          |
| <kbd>\<C-s></kbd> <kbd>←↓↑→</kbd> | Move the pane border one cell                |
| <kbd>Alt+f</kbd>                  | Fill the tab with the focused pane, and back |
| <kbd>\<C-p></kbd> <kbd>x</kbd>    | Close the pane and its process tree          |

## Add a tab [#add-a-tab]

| Keys                                  | Result              |
| ------------------------------------- | ------------------- |
| <kbd>\<C-t></kbd> <kbd>n</kbd>        | Open a tab          |
| <kbd>Tab</kbd> / <kbd>Shift+Tab</kbd> | Next / previous tab |
| <kbd>\<C-t></kbd> <kbd>x</kbd>        | Close the tab       |

## Get out of the way [#get-out-of-the-way]

When a program needs the keys koshi is holding, lock input with
<kbd>\<C-l></kbd>. Every keystroke then goes straight to the program until
you unlock. <kbd>\<C-q></kbd> quits koshi.

## See the live keymap [#see-the-live-keymap]

```bash
koshi keys list
koshi actions list
```

<Callout>
  Nothing above needs a config file. When you want to change it, start at
  [Configuration](/docs/v0.1/configuration).
</Callout>

## Start from a saved layout [#start-from-a-saved-layout]

Write a profile once and open the whole desk with one command:

```bash
koshi --profile dev
```

See [Profiles](/docs/v0.1/configuration/profiles).