The best way to control Claude Code, Codex and more from any computer or phone
Mirrored from https://github.com/Camo67/t3code.git
Synced Nov 21, 03:37 UTC
| 1 | # Terminal |
| 2 | |
| 3 | ## Choose a shell |
| 4 | |
| 5 | Set `T3CODE_TERMINAL_SHELL` in the environment that launches the T3 Code server |
| 6 | to choose the executable used for new terminals. Use an executable name or its |
| 7 | full path, without surrounding quotes or command-line arguments. An unset or |
| 8 | blank value keeps the platform default. If the executable cannot be started, |
| 9 | T3 Code tries its usual fallback shells. |
| 10 | |
| 11 | On Windows, to use Git Bash from a standard Git for Windows installation, run |
| 12 | this in PowerShell: |
| 13 | |
| 14 | ```powershell |
| 15 | [Environment]::SetEnvironmentVariable('T3CODE_TERMINAL_SHELL', 'C:\Program Files\Git\bin\bash.exe', 'User') |
| 16 | ``` |
| 17 | |
| 18 | Fully quit T3 Code, then reopen it from the Start menu and create a new terminal. |
| 19 | If the app still inherits the old environment, sign out of Windows and sign in |
| 20 | again. Git Bash starts as an interactive login shell. Use `bin\bash.exe`, not |
| 21 | `git-bash.exe`, which launches a separate terminal window. |
| 22 | |
| 23 | To restore the default, remove the variable with the same command using `$null` |
| 24 | as its second argument, then restart T3 Code. |
| 25 | |
| 26 | This setting belongs to the machine hosting the server, including when you |
| 27 | connect from another device. It does not change provider-run commands or the |
| 28 | shell used by automatic project setup and settle scripts. |
| 29 | |
| 30 | ## Terminal history |
| 31 | |
| 32 | Each terminal keeps up to 5,000 lines and 8 MiB of scrollback on its environment |
| 33 | server. T3 Code removes the oldest output when either limit is reached. A long |
| 34 | line can be shortened at the start. New terminal output is not truncated. |
| 35 | |
| 36 | These limits apply when you reconnect and when T3 Code restores saved terminal |
| 37 | history. A client can show less scrollback than the server keeps. |
| 38 | |
| 39 | On web and desktop, use Shift+PageUp and Shift+PageDown to read scrollback |
| 40 | without leaving terminal input. Ctrl+Shift+Home and Ctrl+Shift+End jump to the |
| 41 | start and latest output; use Cmd instead of Ctrl on macOS. Full-screen terminal |
| 42 | programs keep these navigation keys. |
| 43 | |
| 44 | To copy all retained output, choose Select all in the terminal's context menu, |
| 45 | then copy. Cmd+A on macOS and Ctrl+Shift+A elsewhere select the same output. |
| 46 | Ctrl+A still moves to the beginning of shell input on Windows and Linux. |
| 47 | Jump to latest in the context menu returns to the current output. |
| 48 | |
| 49 | On iPhone and iPad, long-press the terminal to paste or to choose Select Text. |
| 50 | Select Text shows the visible output, where you can copy text or tap a link. |
| 51 | |
| 52 | ## fish |
| 53 | |
| 54 | T3 Code starts fish with `no-query-term`, avoiding startup waits for terminal |
| 55 | replies. This disables optional fish features that depend on those replies. |
| 56 | T3 Code's exported `fish_features` also hides any universal flags you set with |
| 57 | `set -U fish_features`. |
| 58 | |
| 59 | To preserve those flags or enable queries with `query-term`, include them in |
| 60 | `fish_features` in the environment that launches T3 Code. A shell export applies |
| 61 | when you launch T3 Code from that shell; it does not configure a desktop app |
| 62 | launched from the Dock or Finder. Enabling queries can restore the startup wait. |