How to edit files in the terminal

1. Install the terminal editor

macOS or Linux

Run this in your terminal. On a minimal Linux installation, install the download prerequisites first.

curl -fsSL https://trytte.com/install.sh | sh

The installer shows the published version and build before downloading the binary for your operating system and processor. It verifies the SHA-256 checksum and confirms that the binary matches the announced release before asking where to install.

Alpine, Arch Linux, and Ubuntu prerequisites

All three distributions use the same installer. If curl or trusted CA certificates are missing, run the matching command as root, or prefix each package manager invocation with configured sudo or doas:

The Arch command also performs a full system update. For Ubuntu with sudo, use sudo apt update && sudo apt install curl ca-certificates. See the distribution documentation for Alpine apk, Arch pacman, and Ubuntu APT.

After installing prerequisites, run the macOS/Linux installer above as your normal user. The static Linux binary also runs on Alpine without a glibc compatibility package. Alpine's BusyBox sh/ash and utilities are supported without installing Bash or GNU coreutils.

The installer selects the binary using uname for the operating system and architecture. It checks /etc/alpine-release only to show Alpine setup guidance when curl is missing. It does not detect Arch or Ubuntu or install OS packages automatically. If curl is missing in the one-line download command, the shell fails before the installer can run; install the prerequisites first.

Install location and permissions

Choose the default ~/.local/bin for a per-user installation, or /usr/local/bin for a system-wide installation. A writable destination needs no privilege helper; otherwise the installer uses sudo if available, or doas when sudo is absent. The selected helper must already be configured. Without either helper, run as root or choose a directory you own.

Without a controlling terminal, the default is $HOME/.local/bin; when run as root, this means root's home. Set TTE_INSTALL_DIR to an absolute path on the sh side of the pipeline to skip the prompt:

curl -fsSL https://trytte.com/install.sh | TTE_INSTALL_DIR="$HOME/.local/bin" sh

Use TTE_INSTALL_DIR=/usr/local/bin for an explicit system-wide destination. Run the installer again with the same destination to update that copy.

Add TTE to PATH

The macOS/Linux installer prints commands when the install directory is missing from PATH; it does not edit startup files. It chooses the suggested file from $SHELL, not your distribution or the sh running the installer:

For Alpine using sh/ash, add the default directory once and load it into the current shell:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.profile"
. "$HOME/.profile"

For Bash on Alpine, Arch, or Ubuntu, use the same two commands with "$HOME/.bashrc" instead of "$HOME/.profile". For Zsh, use "$HOME/.zshrc". Choose the file for your actual shell. Other or unset shell names get the .profile fallback; shells with different syntax, such as fish, need their own PATH configuration. For a custom installation directory, replace $HOME/.local/bin with that path.

If Alpine shows .bashrc, your $SHELL reports Bash; the distribution does not force .profile. Check printf '%s\n' "$SHELL" if the suggested file differs from the shell you use.

The installer prints a direct export PATH="...:$PATH" command for the current terminal and a separate command to save it. Restarting Bash with -l does not automatically read .bashrc: login sessions read the first available .bash_profile, .bash_login, or .profile. Have your existing Bash login startup file source .bashrc if you want its settings there too. See Bash startup files.

command -v tte
tte --version

If this selects an older copy, put the intended directory first on PATH. You can also run "$HOME/.local/bin/tte" . directly before configuring PATH.

Windows

Open PowerShell and run:

irm https://trytte.com/install.ps1 | iex

The Windows installer verifies the download, installs TTE for your user account, and adds its directory to your PATH. Open a new terminal if an existing terminal does not recognize the command.

You can also download a binary and its checksum directly. TTE runs as a single binary with no runtime dependencies. Run the installer again to update it.

2. Open a file or a folder

Move to the directory containing your files, then open an existing file:

tte notes.txt

To browse the current folder as a workspace, use:

tte .

A directory argument opens the file explorer. With no argument, tte resumes the current workspace with its saved tabs, drafts, and cursor positions. Use quotes around a path containing spaces:

tte "meeting notes.md"

3. Edit, save, and close

Click in the document or move with the arrow keys and start typing. There is no separate insert mode to enter. Select text by dragging the mouse or holding Shift while moving the cursor.

On macOS these are Control shortcuts inside TTE. The terminal application may keep Command shortcuts for its own actions. The menus also expose the editor commands.

For a new draft, press Ctrl+T. The first save asks for a path. Auto-save is off by default; enable it under TTE → Experimental if you want named files saved after typing pauses. Draft recovery preserves unsaved work in the session, but saving is what updates your actual file.

4. Work with multiple files

Press Ctrl+O for quick-open, or Ctrl+E to show the explorer. Click a folder to expand it; double-click a file to open it in a tab. The tab bar lets you switch between files without leaving the terminal.

Use Ctrl+N to create a named file. The explorer's ⋯ menu provides rename, duplicate, and Move to Trash for files. If another process changes an open file, TTE reloads a clean buffer. If you have unsaved edits too, it keeps them and asks before overwriting either copy.

5. Read Markdown and CSV files

Open a Markdown file and press Ctrl+D to switch between editable source and a rendered preview. The optional outline panel helps navigate headings. For CSV or TSV, Ctrl+K switches between source text and a read-only table with a cell cursor.

Preview mode is for reading. Switch back to source to make changes. TTE can also preview DOCX, PPTX, and PDF documents, and edit binary data in a hex view. See supported file formats and previews.

Editing on a remote machine over SSH

Install TTE on the remote machine, connect over SSH, and run tte . in the remote folder. The editor reads and saves files on that machine.

Selecting text and pressing Ctrl+C sends it to your local terminal's clipboard through OSC 52, if the terminal permits clipboard writes. This also works when the remote host is a Mac. Paste using your local terminal's paste shortcut.

If tmux is in the connection, it may need set -s set-clipboard on. Terminal support and configuration determine whether clipboard forwarding works. In tmux, use Ctrl+E for the explorer; Ctrl+B may be consumed as the tmux prefix.

Common setup questions