rtfm-filemanager 5.10.4 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +54 -9
  3. data/bin/rtfm +2087 -243
  4. data/img/rtfm-kb.png +0 -0
  5. metadata +4 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: bbdf2fd8cd43806dc34350c2fa1e96da2e7e26b4fde0a45c9c493c84f93eda1b
4
- data.tar.gz: 43f3e991053980f681ab74f5c9d7145db0a6eadf3e3577267733d765b9e7588a
3
+ metadata.gz: 8c6297543a83b342e4cba42170a97e4e2bc7658dcd90421b9d4bd722ef9dec0a
4
+ data.tar.gz: d1da910b70de7824eb962b9a6b2dd503cd9c1d815693ef9e23cfba0e8f3ded68
5
5
  SHA512:
6
- metadata.gz: c5a1a986e38c57f317e608215a062a98acfb0299f02da37f559d2b15c5a817cb8f195388a45b47829e83cd82c2f960f923d2096490ebb03f9dff01f2b3cac0d4
7
- data.tar.gz: 17799e4161029bdfa47fba8952aa498487b7a33c45c327c19d0b9371e495e05dc9ec3ab2142d5a5fa8835a94690c9ed5abc523156bb03d5c55bcf195770a8dea
6
+ metadata.gz: dcf19723ec4c58cf99ffe0e5bfce137d1ff4231a799e3abd1bc1b0d04f5699cd556e7cc52e5d723bb6cd62d5ec692dd7571e0821613a0ab18b4099a63406c2c3
7
+ data.tar.gz: c0298ce1cd18884a329602a4e6d92c5b03df0b7008d24535f73344d32bacfdf2146c1e429498f589aed376564917aeca08c376876eea599c02d260861b873688
data/README.md CHANGED
@@ -2,18 +2,20 @@
2
2
 
3
3
  ![Ruby](https://img.shields.io/badge/language-Ruby-red) [![Gem Version](https://badge.fury.io/rb/rtfm-filemanager.svg)](https://badge.fury.io/rb/rtfm-filemanager) ![Unlicense](https://img.shields.io/badge/license-Unlicense-green) ![Stay Amazing](https://img.shields.io/badge/Stay-Amazing-important)
4
4
 
5
- ## Version 5
5
+ ## Version 6.0
6
6
 
7
- Version 5 is a complete rewrite of RTFM using
8
- [rcurses](https://github.com/isene/rcurses) as the underlying library. With
9
- this, RTFM gains more stability, higher quality code and more features.
7
+ Version 6.0 introduces comprehensive remote directory browsing capabilities and enhanced user experience improvements:
10
8
 
11
- Among the new version 5 features are an optional trash bin, advanced OpenAI
12
- integrations, plugin architectures for keybindings, user defined features and
13
- file viewers. You also get better feedback, better visuals, more error
14
- capture. Plenty.
9
+ - **Remote SSH/SFTP browsing** with seamless navigation and file operations
10
+ - **SSH shell integration** for interactive remote sessions
11
+ - **Enhanced help system** with color-coded sections and aligned formatting
12
+ - **SSH connection comments** for better organization (user@host # comment)
13
+ - **Comprehensive undo system** for file operations with safety checks
14
+ - **Performance optimizations** and code cleanup for improved stability
15
15
 
16
- The major feature additions in v5 are marked in ***bold italic***.
16
+ Version 5 was a complete rewrite using [rcurses](https://github.com/isene/rcurses) as the underlying library, providing stability, higher quality code and extensive features including optional trash bin, advanced OpenAI integrations, plugin architectures for keybindings, user defined features and file viewers.
17
+
18
+ The major feature additions are marked in ***bold italic***.
17
19
 
18
20
  ## What?
19
21
  <img src="img/logo.png" align="left" width="150" height="150"> RTFM is a
@@ -55,6 +57,9 @@ features are:
55
57
  * Show git status for the current directory
56
58
  * Show comprehensive system info (processes running, disk space, dmesg, etc.)
57
59
  * See if a directory (with sub dirs) has changed using cryptographic hashes
60
+ * ***Remote directory browsing via SSH/SFTP*** with seamless navigation and file operations
61
+ * ***SSH shell integration*** for dropping into interactive shell sessions on remote hosts
62
+ * ***Remote file operations*** including download, upload, and file info display
58
63
  * Integration with OpenAI to get an executive summary of file content
59
64
  * ***OpenAI chat integrated; Discuss files, content, commands with OpenAI***
60
65
  * ***Enhanced tab management*** with duplication, renaming, and smart navigation
@@ -97,6 +102,46 @@ You can run any command in the bottom "command bar" and have the output
97
102
  presented in the right pane. History of commands are preserved like in your
98
103
  shell.
99
104
 
105
+ ## Remote Directory Browsing
106
+
107
+ RTFM includes comprehensive **remote directory browsing** capabilities via SSH/SFTP, allowing you to seamlessly navigate and manage files on remote servers directly from your local terminal.
108
+
109
+ **Key Remote Features:**
110
+ * **Seamless remote navigation** - Browse remote directories as if they were local
111
+ * **SSH shell integration** - Drop into interactive shell sessions with `s` key
112
+ * **File operations** - Download (`d`), upload (`u`), and view file info (`→`)
113
+ * **Connection caching** - Intelligent caching for improved performance
114
+ * **Multiple connection formats** supported
115
+
116
+ **Connection Examples:**
117
+ ```bash
118
+ # Basic SSH connection
119
+ user@server.com:/path/to/directory
120
+
121
+ # With custom SSH key
122
+ -i ~/.ssh/custom-key user@server.com:/path
123
+
124
+ # SSH URI format
125
+ ssh://user@server.com/path/to/directory
126
+
127
+ # Key at end format
128
+ user@server.com:/path -i ~/.ssh/custom-key
129
+
130
+ # With comments for organization
131
+ user@server.com:/path # Production server
132
+ admin@192.168.1.10 # Local development
133
+ ```
134
+
135
+ **Remote Mode Usage:**
136
+ 1. Press `Ctrl+E` to enter/exit remote mode
137
+ 2. Enter connection string when prompted
138
+ 3. Navigate with standard keys (`←`, `→`, `↑`, `↓`)
139
+ 4. Use `d` to download files, `u` to upload files
140
+ 5. Press `s` to open SSH shell in current remote directory
141
+ 6. Press `Ctrl+E` to return to local mode
142
+
143
+ The remote browsing feature includes visual indicators (red background) to clearly show when you're in remote mode, and all standard RTFM navigation and information features work seamlessly with remote directories.
144
+
100
145
  ## Installation
101
146
  You can install RTFM by cloning this repo and put the file `rtfm` in your
102
147
  "bin" directory. If you do, you need to install