Files and Notes

Documentation in progress

Some sections are still incomplete.

Two capabilities sit alongside the terminal: a file browser that reaches local and remote directories alike, and a Markdown editor bound to a notes Vault you already own.

Files

The file browser shows a tree for the current Project, with a syntax-highlighted preview for the file you select and fuzzy search across the tree. Files can be dragged in and out, and Open With hands a file to another application.

Remote files over SFTP

When a Project lives on a remote host, the same browser works over SFTP. It supports:

• browsing remote directories
• uploads and downloads, including whole directories transferred recursively
• conflict handling when a name already exists at the destination — replace or skip
• retry after a failed transfer
• dropping a file straight onto a remote terminal to upload it there

Downloads are saved to a folder you choose in settings. If none is set, ThinkTerm falls back to the system download location.

Idle connections close by themselves

An SFTP connection that has gone unused is closed rather than held open. The timeout defaults to 15 minutes and can be set anywhere from 1 to 120 minutes. Reopening a remote directory after a timeout reconnects transparently; nothing is lost.

Notes

The Notes panel is a Markdown editor bound to a Vault — a directory of ordinary Markdown files, in the layout Obsidian uses. Nothing is imported and nothing is converted: ThinkTerm records the binding and edits the files where they already are. The same Vault can be open in Obsidian at the same time.

The editor handles:

• tables
• syntax-highlighted code blocks
• spell check
• images, including images loaded from a remote URL
• autosave

Because a Vault is just a directory, it is yours to move, sync, or put under version control. If ThinkTerm cannot open one it says why rather than showing an empty panel. A folder it cannot find is reported as missing — moved, renamed, or deleted, which it cannot tell apart. One it can find but cannot read is reported as a permissions problem, with the check to make for your platform.

Binding a Vault

A Space can be bound to a Vault. You can point one at a directory you already keep notes in, or create a new one. Nothing outside the bound directory is touched.

Related

• Remote — connecting to the host whose files you are browsing
• Configuration — where the Vault binding is recorded