@devries-cameron20 / t3code Mirror · read-only
Fork 0

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

main
md 62 lines 2.89 KB
Rendered Raw
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.