|
| 1 | +--- |
| 2 | +title: Terminal |
| 3 | +--- |
| 4 | + |
| 5 | +Phoenix Code has a built-in terminal so you can run commands without leaving the editor. |
| 6 | + |
| 7 | +> The terminal is available only in desktop apps. |
| 8 | +
|
| 9 | +<!-- Add an image here showing the terminal panel with a couple of tabs and a running command --> |
| 10 | + |
| 11 | +## Opening the Terminal |
| 12 | + |
| 13 | +There are a few ways to open the terminal: |
| 14 | + |
| 15 | +- Click the **Tools** button *(grid icon)* in the bottom-right toolbar and select **Terminal** |
| 16 | +- Go to **View > Terminal** from the menu bar |
| 17 | +- Press `F4` |
| 18 | + |
| 19 | +## Tabs |
| 20 | + |
| 21 | +You can have multiple terminals open at the same time, each in its own tab. The tab sidebar shows the running process name for each terminal. |
| 22 | + |
| 23 | +To create a new tab, click the **+** button at the bottom of the tab sidebar. |
| 24 | + |
| 25 | +To close a tab, hover over it and click the **X** button. If a process is still running, Phoenix Code asks for confirmation before closing. |
| 26 | + |
| 27 | +<!-- Add an image here showing the tab sidebar with multiple terminal tabs --> |
| 28 | + |
| 29 | +## Shell Selection |
| 30 | + |
| 31 | +Click the **dropdown button** *(chevron icon)* next to the new tab button to pick a different shell. The available options depend on your operating system: |
| 32 | + |
| 33 | +- **macOS**: zsh, bash, fish |
| 34 | +- **Linux**: bash, zsh, fish |
| 35 | +- **Windows**: PowerShell, Command Prompt, Git Bash, WSL |
| 36 | + |
| 37 | +Selecting a shell sets it as the default and opens a new terminal with it right away. |
| 38 | + |
| 39 | +> Only shells that are installed on your system are shown. |
| 40 | +
|
| 41 | +## Right-Click Menu |
| 42 | + |
| 43 | +Right-click inside the terminal to access: |
| 44 | + |
| 45 | +- **Copy** - copy selected text |
| 46 | +- **Paste** - paste from clipboard |
| 47 | +- **Clear Terminal** - clear the terminal output |
| 48 | + |
| 49 | +## Keyboard Shortcuts |
| 50 | + |
| 51 | +| Action | Shortcut | |
| 52 | +|--------|----------| |
| 53 | +| Toggle terminal | `F4` | |
| 54 | +| Switch focus between editor and terminal | `Shift + Escape` | |
| 55 | +| Clear terminal buffer | `Ctrl/Cmd + K` | |
0 commit comments