Files

Open Files

Click a folder to expand it, double-click a folder to open it as a folder tab, or double-click a file to open it as a file tab. Reopening an already-open file focuses the existing tab instead of creating a duplicate.

You can also drag a file or folder from the explorer onto the tab area to open it there. On a touch screen, a tap works like a click; hold an entry for one second, then drag it or release to open its context menu.

Each entry in the explorer shows a distinct icon for its file type. The tree follows changes made outside Terminay on its own, and the Reload explorer button in the Files header rescans it on demand.

Markdown And MDX

Opening a .md or .mdx file from the explorer, a folder tab, or a link opens it in the Documentation view, the same rich editor used by the Documentation sidebar. Choose View source in its toolbar to switch that tab to the file viewer described on this page, and Open as document to switch back.

Opens that ask for a specific mode keep the file viewer: a changed file opened from the Git panel opens in Diff, and a task opened from a folder's Tasks view opens in Tasks.

View Modes

• Preview: shows supported content in a readable view. Markdown is rendered, images and PDFs are displayed, and text/code files are shown read-only with highlighting where available.
• Text: opens editable text files in Monaco by default. Large text files may ask you to choose between Performant mode and Monaco.
• HEX: shows bytes with offset, HEX, and ASCII columns. Invalid byte values are marked and must be fixed before saving.
• Diff: shows the file's Git diff against HEAD when the file is tracked in a Git repository, as Unified or Side by side.

Files open in Preview. Text and HEX are editable and share one draft, so switching modes keeps your unsaved edits. Preview and Diff are read-only.

Unsupported or binary files fall back to HEX when Preview or Text are not available. Preview explains when a preview type is unavailable, and Text mode is disabled for binary files.

Tasks

Markdown files get a dedicated Tasks view mode in the file viewer: a completion ring, heading groups, a Kanban board, filters, and Git diff awareness. See the Tasks guide for the full feature.

Language Features

Text mode highlights syntax for common languages. Errors and warnings, completion, hover information, and go to definition come from language server extensions that run on the server that owns the project. The bundled TypeScript extension covers TypeScript and JavaScript files (.ts, .tsx, .mts, .cts, .js, .jsx, .mjs, .cjs) and uses the project's own TypeScript when it is installed.

Because the language server runs beside the files, these features work the same from the desktop app and from a paired browser. Following a definition into another project file opens that file in Text mode. Files with no matching extension are still highlighted and editable, without those features. Manage language extensions in Settings → Extensions.

Save And Sync

The status bar shows the full file path, file size, active engine, and save state. Synced means the file matches disk. Unsaved changes means your current tab has local edits.

Save the active file with Cmd/Ctrl+S. After saving, Terminay refreshes the file's Git diff and status. If a save fails, your draft is kept.

External Changes And Conflicts

If a file changes on disk while you have no local edits, Terminay reloads it automatically. If it changes on disk while you have unsaved edits, Terminay keeps your draft and shows a conflict banner.

• Reload from disk discards your draft and loads the disk version.
• Keep local edits keeps your draft so you can continue editing or save your version.

Large Files

For large text files over 100 MB, Terminay asks how to open the file each time. Performant mode keeps the viewer lighter and shows a truncated text window. Switch to Monaco before saving the full file. Monaco opens the full editor but may use more memory.

Git Status And Diff

When Git is available for the project, the file explorer marks new files and folders in green and modified files and folders in amber. Status updates as files change, including changes made outside Terminay.

Diff mode is available only for tracked files. Untracked files show that a diff is unavailable. Binary Git diffs show a binary-diff message instead of text hunks.

File Operations

Right-click files and folders for file operations. Folders offer Create new file, Create new folder, Rename, Delete, Copy path, Copy relative path, and Open shell in folder. Files offer the same actions without the two create items. Creating a file opens it in Text mode. Delete asks for confirmation.