# Termin8

Termin8 is a native Mac terminal for shells, agents, browser tabs and document previews. Keep a terminal open, put a reference beside it and arrange the panes around the work you are doing. You can use it locally without an account. Connecting to Ouros is optional.

**Termin8 window with a Markdown file beside a shell**

[Open the interactive Studio scene](/docs/studio-artifacts/docs-scenes/termin8.html)

## Start with a terminal

1. Open [the Termin8 download section](https://ouros.md/download#termin8).
2. Choose the disk image for your Mac: Intel or Apple Silicon.
3. Open the disk image and drag Termin8 into Applications.
4. Open Termin8 and start with a shell.

Termin8 is free to use and requires macOS 11 or later. It is not open source.

## Give your work room

Open another terminal tab with **Command T**. Split to the right with **Command D**, or below with **Command Shift D**. Keep a second shell or an agent beside the work you are checking.

Fold an extra pane when you want to focus. Terminals and browser tabs share a drawer, so you can keep the sessions you use close and tuck the drawer away when you need the space.

Saved shells and agents can reopen with their scrollback. Check the session you have returned to before sending another command.

## Keep a page or document nearby

Use **Command K** to find actions and settings. Choose **Browser** to open a web page, or **Preview file** for a local document. You can keep a page or reference beside your terminal instead of moving between separate windows.

A page open in the browser and a local document preview are different views. Do not assume that a preview runs a document's scripts or supports every file type.

## Find a command or earlier output

| Shortcut | Action |
| --- | --- |
| Command K | Open actions and settings |
| Command T | Open a terminal tab |
| Command D | Split right |
| Command Shift D | Split below |
| Command F | Find text in terminal scrollback |
| Command B | Open the sidebar |
| Command J | Enter a background command |

**Command J** is for a noninteractive background command. Its output stays in the sidebar for the current app run. Do not treat that output as a permanent record or confuse it with a saved terminal session.

## Accounts and updates

You do not need an account to use the terminal locally. If you want to connect to Ouros, open **Command K**, choose **Ouros account** and follow the sign-in flow.

Use **Check for updates** to look for a release. When an update is available, **Install and restart** installs the signed release and restarts the app.

## Continue

- [Explore Termin8](https://ouros.md/products/termin8)
- [Download Termin8](https://ouros.md/download#termin8)
- [Read the published release README](https://github.com/janestreetshiller/termin8-releases/releases/download/v0.4.11/README.md)

## Task guides

- [Start your first session](/docs/termin8/quickstart)
- [Keyboard reference](/docs/termin8/keyboard-reference)
- [Troubleshoot a session](/docs/termin8/troubleshooting)