Files and Git

Read and edit a repository's files, and follow its history and pull requests, in tiles beside your terminals.

Open a tile

From a pane's ... menu choose Files here or Git graph for this repo, or run Open Files here or Open the Git graph for this repo from the command palette. The tile opens beside the pane, in its folder. Files follows the focused terminal's folder in Auto, or stays on a folder you pick in Manual.

Both read only folders you chose in Splitterm: a project's folders, or one you open from the tile.

The editor

A single click in the tree previews a file; a double click, Enter or an edit keeps it open. Each open file is a tab in the tile, with its own undo. The editor has syntax colours, line numbers, bracket matching, folding and several cursors, and Find, Replace and Go to line float over the text. Its keys are on Keyboard shortcuts.

The editor's font is Editor font in Settings > Terminal. Wrap long lines is in Settings > General, and Alt+Z switches it in the editor.

Saving

Auto-save, on by default, saves shortly after you stop typing and when you click away. With it off, in Settings > General, you save with Save or Ctrl+S. A dot on a tab marks text not saved yet.

Text is never lost

Text you have not saved is kept as a draft on this machine. Closing the tile, its tab or Splitterm keeps it and asks nothing; open the file again and your text comes back, with a bar that says so. A draft never leaves the machine.

Only text that cannot be kept, because it is too large or the drafts are full, makes a close ask first. Closing one file's tab with text not saved asks Save, Don't save or Cancel.

When a file changes on disk

Splitterm looks at your open files every second. A file you have not changed simply follows the disk. When you have unsaved text and the file changed too, it asks: Compare shows the two side by side, Reload takes the disk's version, one undo away from yours, and Keep mine keeps your text, so your next save writes over the change. A save never writes over a change you have not seen.

A file deleted while open keeps its text, and saving puts it back.

Files come back as they were

Saving keeps a file's encoding, its byte order mark and every line's own ending. A file up to 5 MB opens for editing; a larger one opens its first 5 MB to read.

The tree

The tree works from the keyboard: the arrows, Enter to open, Space to preview, F2 to rename and Delete, which asks first. It marks the file in front and every file with unsaved text. Drag its edge to resize it, or hide it from the tile's menu. Settings > General has Show hidden files, Exclude from tree and Animate folders opening.

The Git tile

The Git tile draws the repository's history as a graph, with its branches and a search. Open a commit, or a changed file of the working tree, to see its diff beside the graph; Back, Escape or the mouse's back button returns to the graph.

Open in Files opens a changed file in Files, and a double click on a line of the new side opens it at that line. Show commit avatars, in Settings > General, fetches GitHub pictures of authors; off, the graph shows initials and touches no network.

Pull requests

With the GitHub CLI installed and signed in, the Git tile lists the repository's open pull requests and how their checks stand. A pull request that a run opened, or that comes from a run's branch, shows its issue's tag, which opens the issue.

Every row has a menu, from its more button or a right click. Copy reference copies a one-line reference to it, and Send to terminal pastes that line into a terminal of the tab, without pressing Enter. File an issue from this opens the composer filled in. A commit row has the same Copy reference and Send to terminal.