mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-10-01 16:01:56 +00:00
l0ng-ai
fed4aec170
Every placeholder frame in docs/ now shows a real capture of the current build: 20 screenshots plus two short looping clips (prompt editor, pane drag). The README and the docs home page link a one-minute tour covering agent status across repos, one agent driving another through the CLI, the prompt editor, diffs, pane dragging, and sessions surviving a quit.
60 lines
2.2 KiB
Plaintext
60 lines
2.2 KiB
Plaintext
---
|
|
title: "SFTP"
|
|
description: "A file browser for the machine on the other end of the connection."
|
|
---
|
|
|
|
While a pane is in an SSH session, *SSH: Remote Files* (command palette) slides
|
|
a file panel in over it. It is a real SFTP client on the same connection — no
|
|
second login, no second password.
|
|
|
|
<Frame caption="The SFTP panel over an SSH pane, a download in progress">
|
|
<img src="/images/sftp-panel.webp" alt="The tty7 SFTP panel" />
|
|
</Frame>
|
|
|
|
## Browsing
|
|
|
|
The panel opens wherever the pane's shell currently is. If tty7 cannot tell
|
|
(the remote shell does not report its directory), it opens on the last folder
|
|
you browsed in that pane, or on the remote home directory the first time.
|
|
Switching between panes with the panel open brings each pane back to the folder
|
|
you left it on. **Go to Shell Directory** in the overflow menu jumps back to the
|
|
shell's directory at any time.
|
|
|
|
Right-click a row for **Edit** (**Open** on a directory), **Download**,
|
|
**Follow Symlink**, **Rename**, **chmod…**, and delete. The overflow menu adds
|
|
**New Folder**, **New File**, **Upload…**, and **Refresh**.
|
|
|
|
## Editing
|
|
|
|
Click a text file and it opens in the [built-in
|
|
editor](/window/side-panel), the same gesture as the local file tree; saving
|
|
writes straight back over the same connection. Files the editor cannot hold —
|
|
binary, or over its 4 MB limit — say so instead; right-click → **Download**
|
|
for those.
|
|
|
|
## Transferring
|
|
|
|
| Direction | How |
|
|
|---|---|
|
|
| Download | Right-click → **Download** |
|
|
| Upload | **Upload…**, or drag files into the panel |
|
|
|
|
Uploads are written under a temporary name and renamed into place at the end, so
|
|
a half-finished file never looks like a finished one. A name that is already
|
|
taken asks before replacing.
|
|
|
|
**Transfer History** in the overflow menu shows every transfer with its
|
|
progress, and lets you cancel one in flight. The panel header summarises what is
|
|
happening — *"2 transferring · 64%"*.
|
|
|
|
## Permissions
|
|
|
|
**chmod…** takes an octal mode (`755`, `600`). The current mode is shown in the
|
|
row's editor before you change it.
|
|
|
|
<Tip>
|
|
For files in a [remote workspace](/remote/workspaces) you can often skip SFTP
|
|
entirely — the Files panel reads and writes across the link directly, and the
|
|
built-in editor saves back to the remote machine.
|
|
</Tip>
|