Terminal
Run your usual shell and terminal applications. Search long logs, copy an error, or share a screenshot of the terminal.
Shells and applications
Section titled “Shells and applications”To choose a shell, open Settings → Shell & sessions → Shell and set Program and Args. New terminals use the updated command; existing shells keep running.
Shells can report their current directory and command for the sidebar’s tab information. Cretty reads those reports without changing your shell startup files.
For SSH hosts that do not recognize xterm-cretty, see
remote terminal setup.
Search a terminal
Section titled “Search a terminal”Press Cmd+F on macOS or Ctrl+Shift+F on Linux/Windows, then type your search text. Search is case-insensitive and includes scrollback. Press Enter for the next match, Shift+Enter for the previous one, and Escape to close search.
To find a different terminal, use the command palette or tab switcher.
Read long output
Section titled “Read long output”Scroll with the wheel or trackpad, or use the scrollback shortcuts. In Settings → Shell & sessions, adjust:
- Scrollback: how many lines of history to keep.
- Smooth scrolling: continuous wheel and trackpad movement.
- Scroll on output: whether new output returns you to the bottom.
- Scroll on keystroke: whether typing or pasting returns you to the bottom.
History stays with the running terminal. Restoring a session starts new shells with no previous output.
Copy text or an image
Section titled “Copy text or an image”Drag to select text. Double-click selects a word; triple-click selects a line. Use Cmd+C on macOS or Ctrl+Shift+C on Linux/Windows to copy it.
| Capture | macOS | Linux/Windows |
|---|---|---|
| Visible screen as text | Cmd+P |
Ctrl+Shift+P |
| Screenshot to clipboard | Cmd+Shift+O |
Ctrl+Shift+O |
| Screenshot to a PNG file | Cmd+Option+Shift+O |
Ctrl+Shift+Alt+O |
Copy raw screen copies the visible screen, not the entire scrollback. Screenshots keep the terminal’s colors and images, without the sidebar. Adjust fonts and spacing before capturing if needed.
Paste with Cmd+V on macOS or Ctrl+Shift+V on Linux/Windows. See clipboard permissions if a terminal application cannot access the clipboard.
Follow links and view images
Section titled “Follow links and view images”Hold Cmd on macOS or Ctrl on Linux/Windows and click a link to open it. Cretty recognizes visible URLs and links supplied by terminal applications. Enable Hyperlinks in Settings → Shell & sessions if needed.
Image-capable applications can display Sixel, Kitty, or iTerm2 graphics inline. The program must send image data; a filename alone is not enough.
Supported terminal standards
Section titled “Supported terminal standards”These are the implemented protocol families and their scope.
Display and input
Section titled “Display and input”| Standard or protocol | Support |
|---|---|
| VT/xterm-style controls | Cursor movement, erasing, scrolling, and alternate-screen applications. |
| ANSI SGR colors and attributes | 16-color palettes, 256 colors, 24-bit RGB, bold, italic, underline, and other text attributes. |
| Kitty keyboard protocol | Negotiated extended keys, modifiers, and key event reporting. |
xterm modifyOtherKeys |
Modified-key encoding when requested by an application. |
| Mouse reporting | Legacy, button, drag, motion, SGR, and SGR pixel coordinates. |
| Bracketed paste and focus reporting | Paste boundaries and focus events when requested. |
| OSC 22 pointer shape | Application-requested mouse pointer shapes. |
Shell and desktop integration
Section titled “Shell and desktop integration”| Standard or protocol | Support |
|---|---|
| OSC 8 hyperlinks | Explicit links supplied by applications. |
| OSC 52 clipboard | Writes from the focused terminal; clipboard reads are denied. |
| OSC 133 and OSC 633 shell integration | Prompt and command boundaries, reported command lines, exit codes, and properties. |
OSC 7 and OSC 1337 CurrentDir |
Reported working directories. |
| OSC 9;4 progress | Percentage, indeterminate, warning, and error states. |
| BEL and OSC 777 notifications | Terminal bells and structured notify messages. |
Inline graphics
Section titled “Inline graphics”Sixel, Kitty graphics, and iTerm2 inline images support image placement and resize reflow. Images share a 320 MiB graphics quota per terminal.
Current limits
Section titled “Current limits”Shell details and progress require the application to send the relevant sequences. Advanced queries such as DECRQSS have partial support; underline variants render as a straight underline. Rectangular selection is not yet supported. For API details and remaining limits, see the terminal crate README.