⚡ A fast, keyboard-driven terminal file manager built in Rust. Dual-pane tree+preview, Vim keybindings, fuzzy finder, embedded terminal, inline editor, and Catppuccin themes.
Repo NguyenSiTrung/FileManagerTUI, read from GitHub 16 h ago. NguyenSiTrung has not joined Take My Repo.
NguyenSiTrung/FileManagerTUI is a public repo on GitHub by NguyenSiTrung. ⚡ A fast, keyboard-driven terminal file manager built in Rust. Dual-pane tree+preview, Vim keybindings, fuzzy finder, embedded terminal, inline editor, and Catppuccin themes. It declares the MIT license on GitHub. It is written mainly in Rust, has 3 stars and last changed on 2026-10-05. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
A fast, keyboard-driven terminal file manager built with Rust and Ratatui.
j/k/g/G and arrow keysTab inside Quick Open switches to a bounded, cancellable literal content search over the workspace/ to filter the current directory treeSpace to select, batch operations on selection--no-icons).ipynb cells with syntax highlightingindex.lockcargo install --git https://github.com/NguyenSiTrung/FileManagerTUI.git
Download the latest binary for your platform from the Releases page:
| Platform | Binary |
|---|---|
| Linux (x86_64, static) | fm-x86_64-unknown-linux-musl |
| Linux (.deb package) | fm-tui_<version>_amd64.deb |
| Linux (AppImage) | fm-tui-x86_64.AppImage |
| macOS (Intel) | fm-x86_64-apple-darwin |
| macOS (Apple Silicon) | fm-aarch64-apple-darwin |
| Windows | fm-x86_64-pc-windows-msvc.exe |
# Linux / macOS — raw binary
chmod +x fm-*
sudo mv fm-* /usr/local/bin/fm
# Linux — Debian/Ubuntu .deb package
sudo dpkg -i fm-tui_*_amd64.deb
# Linux — AppImage (portable, no install needed)
chmod +x fm-tui-x86_64.AppImage
./fm-tui-x86_64.AppImage
git clone https://github.com/NguyenSiTrung/FileManagerTUI.git
cd FileManagerTUI
Option A — Use the install script (recommended):
./scripts/install.sh
This handles everything: installs Rust if missing, builds the binary, and installs it as fm.
Option B — Install via Cargo:
cargo install --path .
Option C — Manual build and install:
cargo build --release
# Copy binary to your PATH
cp target/release/fm ~/.cargo/bin/fm
# Or system-wide:
sudo cp target/release/fm /usr/local/bin/fm
Make sure
~/.cargo/binis in your PATH. If not, add to your~/.bashrcor~/.zshrc:source "$HOME/.cargo/env"
pip install awscligit silently disables thempylsp, yaml-language-server, rust-analyzer; see Language servers (LSP)# Open current directory
fm
# Open a specific path
fm ~/projects
# Use a custom config file
fm -c ~/.config/fm-tui/config.toml ~/projects
# Minimal mode (no icons, no mouse, no watcher)
fm --no-icons --no-mouse --no-watcher
# Disable embedded terminal
fm --no-terminal
# Disable Git indicators
fm --no-git
# Browser-terminal workspace routes (explicit opt-in)
fm --keymap-profile web
# Disable automatic preview, not explicit text document opening
fm --no-preview
# Light theme
fm --theme light
# Browse an S3 bucket
fm s3://my-bucket
# Browse an S3 prefix with a specific AWS profile
fm s3://my-bucket/experiments/run-1/ --aws-profile mfa
Enter on a file and Quick Open open supported local text directly. Clean automatic preview documents may be replaced; editing or pinning retains a document. Tabs, next/previous/list navigation preserve each document's cursor, find query, undo, dirty content and view state. Binary/invalid-UTF-8/oversized/read-only files and notebooks keep supported read-only preview behavior; S3 remains read-only.
Saving targets the retained/captured document, never an unrelated selected preview. Close and quit offer save/discard/cancel for dirty documents; cancelled or failed saves retain their buffers. External disk revisions stop unsafe saves; Save As creates a new destination with explicit overwrite/conflict checks.
F8 or the status-bar Commands mouse button opens a searchable command menu.
The rendered button and menu title reflect current bindings; the button remains
clickable when keyboard entry is unbound. Menu dismissal uses its own configured
Menu-context bindings plus native Esc. Help (? in tree/preview) lists the
originating context's active bindings, unbound commands and disabled reasons.
Git indicators, private recovery and installed-server LSP are implemented and
described below. Commands remain context-gated: an unavailable action reports
its reason rather than running in the wrong context.
Both profiles provide Alt+G, then a suffix in ordinary tree/preview/editor/shell contexts:
| Suffix | Command |
|---|---|
m |
Commands menu |
s / a / q |
Save / Save As / Close retained document |
o |
Quick Open |
d / n / b |
List / next / previous document |
1 / 2 / 3 / 4 |
Explorer / retained editor / shell / selected preview focus |
t / w |
Toggle terminal / wrap the actual text view |
Standard also retains contextual Ctrl+S/Ctrl+P/Ctrl+T and directional focus shortcuts. Web omits those registered Ctrl routes, avoiding exclusive dependence on browser-reserved Ctrl+P/T/S/R. Profiles are explicit, not auto-detected. Browser, OS, locale and extension delivery still varies: controlled PTY tests are not real-browser or Kubeflow certification. Native editor controls remain native.
A pending prefix times out after 1200 ms by default (100–10000 ms configurable). Esc, mismatch, timeout or context change cancels and consumes the suffix, without replaying it as shell/editor/tree input. Paste, mouse-down, document activation, focus and live replacement reset sequences. External cancellation/replacement of a pending prefix quarantines one subsequent key, deliberately dropping a delayed suffix rather than risking a destructive action. Literal textual prefixes, conflicting/unknown bindings and nonportable encodings are rejected.
These controls are panel-local; explicit workspace overrides take precedence. Workspace commands and their authoritative configured shortcuts are in Help.
| Key | Action |
|---|---|
j / ↓ |
Move down |
k / ↑ |
Move up |
g / Home |
Jump to first item |
G / End |
Jump to last item |
Enter |
Expand directory / open text document |
l / → |
Expand directory |
Backspace / h / ← |
Collapse directory / go to parent |
Tab |
Cycle panel focus (forward) |
Ctrl+←/→ |
Focus left/right panel |
Ctrl+↑/↓ |
Focus up/down (terminal) |
. |
Toggle hidden files |
Space |
Toggle multi-select |
Esc |
Clear multi-selection |
s |
Cycle sort (name → size → modified) |
S |
Toggle directories first |
| Key | Action |
|---|---|
a |
Create new file |
A |
Create new directory |
r |
Rename |
d |
Delete |
y |
Copy to clipboard |
x |
Cut to clipboard |
p |
Paste from clipboard |
Ctrl+Z |
Undo last operation |
| Key | Action |
|---|---|
Ctrl+P |
Open fuzzy finder |
/ |
Start inline filter |
Esc |
Cancel / clear filter |
Enter |
Accept filter / Open action menu |
Tab (in Quick Open) |
Toggle project content search (literal, bounded, cancellable) |
Quick Open normally opens directly. Its secondary action menu offers:
| Key | Action |
|---|---|
Enter |
Navigate (Go to file in tree) |
p |
Preview (navigate + focus preview) |
e |
Edit (open inline editor) |
y |
Copy absolute path to system clipboard |
r |
Rename file |
d |
Delete file |
c |
Copy to clipboard |
x |
Cut to clipboard |
t |
Open parent dir in terminal |
Esc |
Back to search results |
Context filtering: Edit/Preview are hidden for directories; Edit is hidden for binary files.
| Key | Action |
|---|---|
j / ↓ |
Scroll down |
k / ↑ |
Scroll up |
g / Home |
Jump to top |
G / End |
Jump to bottom |
Ctrl+D |
Half page down |
Ctrl+U |
Half page up |
Alt+G w / Commands → Wrap |
Toggle the actual text view’s wrap |
Ctrl+Shift+C / Ctrl+C (when selected) |
Copy selected preview text |
| Right click | Copy selected preview text |
| Commands → Cycle selected preview mode | Full → head/tail → head → tail; full respects byte budget |
+ / - |
Adjust head/tail lines |
e |
Enter edit mode |
| Key | Action |
|---|---|
Esc |
Exit edit mode (prompt if unsaved) |
Ctrl+S |
Save file |
Arrow keys |
Move cursor |
Home / End |
Start / end of line |
Ctrl+Home / Ctrl+End |
Top / bottom of file |
PgUp / PgDn |
Page up / page down |
Tab / Shift+Tab |
Indent / dedent |
Ctrl+Z |
Undo |
Ctrl+Y |
Redo |
Ctrl+C |
Copy selection, or current line |
Ctrl+X |
Cut selection, or current line |
Ctrl+V |
Paste |
Ctrl+F |
Find |
Ctrl+H |
Find & Replace |
Ctrl+A (in replace) |
Replace all |
Shift+Arrow |
Extend text selection |
Ctrl+A |
Select all text |
| Mouse click | Position cursor at click point |
| Mouse drag | Select text |
| Scroll wheel | Scroll editor viewport |
| Key | Action |
|---|---|
Ctrl+T |
Toggle terminal panel |
Ctrl+Shift+↑ |
Grow terminal height (Standard profile) |
Ctrl+Shift+↓ |
Shrink terminal height (Standard profile) |
Esc / q / Tab / Ctrl+C |
Forward to shell (including Ctrl+C with selected text) |
Shift+↑/↓ |
Scroll terminal history |
Shift+PgUp/PgDn |
Fast scroll terminal history |
Only configured workspace routes and native terminal scroll/distinct copy actions are intercepted. Shell Ctrl+A/E/U/K/W retain their normal semantics; Ctrl+W is not wrap. Unreserved Alt chords forward their ESC prefix. Copy uses distinctly delivered Ctrl+Shift+C/Super+C or right-click, not ordinary Ctrl+C.
| Key | Action |
|---|---|
? |
Toggle help overlay |
q |
Quit in tree/preview |
Ctrl+C |
Quit in tree/preview (selected preview text copies instead) |
F5 |
Manual refresh |
Ctrl+R |
Toggle tree auto-refresh (open-document change detection stays active) |
| Action | Behavior |
|---|---|
| Left click (tree) | Select item |
| Left click (selected dir) | Expand/collapse |
| Left click (preview) | Focus preview and start text selection |
| Left drag (preview) | Extend text selection |
| Right click (preview) | Copy selected preview text |
| Scroll wheel | Navigate tree / scroll preview |
Configuration is loaded from multiple sources with the following priority (highest wins):
--no-mouse, --theme light, --keymap-profile web)--config / -c file$FM_TUI_CONFIG (path to config file).fm-tui.toml in current directory~/.config/fm-tui/config.toml[keymap]
profile = "web"
timeout_ms = 1200
[[keymap.bindings]]
command = "document.save"
context = "editor"
keys = ["F9", "Alt+G s"]
# Remove all terminal-toggle routes in shell context.
[[keymap.bindings]]
command = "pane.terminal.toggle"
context = "terminal"
keys = []
# Menu dismissal is independent of editor entry.
[[keymap.bindings]]
command = "workspace.commands"
context = "menu"
keys = ["F9"]
Sources merge by (command, context); each incoming pair replaces that pair's
complete profile/lower-priority routes. Omitted pairs remain; keys = [] unbinds.
A CLI profile override preserves TOML binding overrides. Include original keys to
retain them when adding a key. Startup config errors fail before TUI setup.
Help's Settings tab registers an explicit profile selector and merges partial settings with the current effective config. Compilation and file validation precede atomic persistence and live application. Failure reports no save/apply, keeps previous live bindings/state and retains unsaved settings edits. Settings saves capture exact source bytes and their revision together before merging, then reuse the shared bounded safe-save policy. Source/generated config are limited to 1 MiB; validation reads are capped at the captured revision size plus one growth-detection byte. Existing private modes and ownership are preserved or the save refuses; symlinked destinations/ancestors, hardlinks, read-only files and unpreservable ownership/extended permissions are refused without dropping the original file or live state. New Unix configs use a restrictive 0600 default. Changed/deleted/replaced destinations and creation collisions fail safely. Final revision validation followed by publication remains advisory under trusted parents, not filesystem compare-and-swap; a last validation/publication race is not claimed closed.
Preview disable (--no-preview or [preview] enabled = false) suppresses automatic
legacy preview reads/admission, but explicit editable opens and retained editors
remain available. Wrap changes the originating text view only; other retained
documents keep their local wrap/horizontal offsets. full respects the configured
byte budget; head_tail is an alias for head_and_tail. View cycling is a menu
command, not Ctrl+T. Editor byte/line limits apply to new admission without
silently evicting existing buffers.
Watcher preferences survive editor/focus transitions. The in-app Ctrl+R toggle
and watcher.auto_refresh control tree auto-refresh only: while they are off,
already-open documents still detect external writes (no global suppression). To
stop change detection entirely, launch with --no-watcher or set
watcher.enabled = false; configuration-disable cannot be temporarily resumed by
Ctrl+R, and enabling a watcher that was not started at launch requires restart.
Backend debounce, mouse capture and default shell
startup options require restart; changing the default shell does not restart an
existing process. Theme changes retain the existing live highlighting policy.
Terminal scrollback applies at startup and live, clamped to 0–100000 lines
(default 1000). Shrink removes only oldest history, clamps scroll position and
clears/rebases affected selections; grid, cursor and process remain intact.
Changing history capacity never spawns a shell or enables a disabled terminal.
Editor paste is literal text (not simulated keys), with a 1 MiB bound. Text clipboard fallbacks use internal text, optional platform tools, OSC52 and a selectable copy overlay. OSC52 transport is unconfirmed: it does not prove the host/browser clipboard changed. File copy/cut/paste remains separate from text clipboard. No real-clipboard browser certification is claimed.
config.toml[general]
show_hidden = false
confirm_delete = true
mouse = true
# Content search (Quick Open → Tab) is bounded; values shown are the defaults.
# search_exclude_dirs = [".git", "target", "node_modules", ".venv"] # replaces built-in list
# search_max_files = 20000
# search_max_hits = 2000
# search_max_file_bytes = 2097152
# search_max_bytes_scanned = 134217728
# search_max_excerpt_bytes = 200
[preview]
enabled = true
max_full_preview_bytes = 1048576 # 1 MB
head_lines = 100
tail_lines = 50
default_view_mode = "full" # bounded full, head_and_tail (alias head_tail), head_only, tail_only
tab_width = 4
line_wrap = false
syntax_theme = "base16-ocean.dark"
[tree]
sort_by = "name" # "name", "size", "modified"
dirs_first = true
use_icons = true # Set to false for ASCII-only mode
[watcher]
enabled = true # false disables change detection entirely (no backend)
auto_refresh = false # tree auto-refresh only; open-document detection stays on
debounce_ms = 300
mode = "event" # "event" (native notifications) or "polling" (mounted storage)
poll_interval_ms = 2000 # polling only; clamped to 250..=60000
[git]
enabled = true # read-only branch/status indicators; --no-git overrides
[recovery]
enabled = true # private snapshots of dirty documents
# state_dir = "~/.local/state/fm-tui/recovery" # defaults to the platform state dir
max_records = 32 # retained snapshots per workspace, clamped 1..=1024
max_age_secs = 604800 # 7 days; clamped 3600..=~100 years
min_interval_ms = 2000 # throttle between snapshot writes
[lsp]
enabled = true # subsystem gate; servers still need a resolvable argv
# Installed-server examples — executable must exist on PATH (or absolute path).
[lsp.servers.python]
argv = ["pylsp"] # pip install python-lsp-server
# argv = ["pyright-langserver", "--stdio"] # npm i -g pyright
root_markers = ["pyproject.toml", "setup.py", ".git"]
[lsp.servers.yaml]
argv = ["yaml-language-server", "--stdio"] # npm i -g yaml-language-server
root_markers = [".git"]
[lsp.servers.rust]
argv = ["rust-analyzer"] # rustup component add rust-analyzer
root_markers = ["Cargo.toml"]
# Map an extension to a configured language.
[lsp.languages]
templ = "html"
# Durable execution grant — global config only. Project-local
# [[lsp.trust]] entries are ignored on purpose: a checked-out repo must
# not be able to grant its own argv execution.
[[lsp.trust]]
root = "~/src/myproject"
argv = ["pylsp"]
[layout] # pane preferences; temporary maximize is never persisted
explorer_width = 24
explorer_visible = true
terminal_height = 7
terminal_visible = false
[session]
enabled = true # workspace-scoped session restore
# state_dir = "~/.local/state/fm-tui/sessions" # defaults to the platform state dir
[terminal]
enabled = true
scrollback_lines = 1000 # clamped to 0..100000, live without shell restart
[theme]
scheme = "dark" # "dark" or "light"
# Optional custom color overrides (hex format)
[theme.custom]
tree_dir_fg = "#89b4fa"
tree_file_fg = "#cdd6f4"
tree_hidden_fg = "#585b70"
tree_selected_bg = "#45475a"
tree_selected_fg = "#cdd6f4"
border_fg = "#585b70"
border_focused_fg = "#89b4fa"
status_bar_bg = "#1e1e2e"
status_bar_fg = "#cdd6f4"
preview_fg = "#cdd6f4"
dialog_bg = "#313244"
dialog_fg = "#cdd6f4"
Inside a Git work tree the status bar shows the branch label, and the tree
marks modified/untracked files and directories containing them. The backend
is strictly read-only: the only query ever run is
git status --porcelain=v2 -z --branch, always with --no-optional-locks
and GIT_OPTIONAL_LOCKS=0, so status can never take index.lock or write
to the repository. A missing or failing git executable degrades silently
to no indicators. Disable with --no-git or [git] enabled = false; both
remove every decoration and stop further queries.
fm can talk to installed language servers over stdio JSON-RPC for diagnostics and language features (completion, hover, definition, references, symbols). Nothing is downloaded — a server is spawned only when its argv resolves to an executable.
[lsp]
enabled = true
[lsp.servers.python]
argv = ["pylsp"]
root_markers = ["pyproject.toml", "setup.py", ".git"]
See the example config.toml above for Python (pylsp /
pyright-langserver), YAML (yaml-language-server --stdio) and Rust
(rust-analyzer) setups, plus [lsp.languages] extension overrides.
Not every server implements every feature; missing capabilities degrade
to their absence, never to a crash.
Trust model. A server argv from the global config (~/.config/fm-tui/config.toml)
is trusted configuration. An argv found only in a project-local config is
untrusted: the first matching document opens a trust prompt, and approval is
bound to the exact (workspace root, argv) pair for this session only —
nothing is persisted. Durable grants are written by you, in the global
config, as [[lsp.trust]] root = "…" argv = […]; [[lsp.trust]] entries in
a project-local file are ignored (a checked-out repo cannot grant its own
execution). Session restore never carries execution trust. Headless runs
deny untrusted argv outright instead of prompting.
lsp.status shows the negotiated capability/encoding state; lsp.restart
restarts the current document's server. A missing executable or a server
that never completes initialize surfaces as a status note and otherwise
behaves like no server. The automated test matrix exercises fake peers —
including malformed and slow servers — over the real stdio transport; it
never downloads or runs a real language server.
If fm exits while a document has unsaved changes (crash, kill -9,
terminal loss), the next launch offers a recovery prompt: restore the
snapshot into a dirty buffer (r), discard it (d), or dismiss (Esc/n)
— dismissing keeps the record. Restoring never writes the original file;
it produces an ordinary dirty buffer you can edit or save.
Snapshots are bounded and private:
0700 directory, 0600
records, atomic rename); symlinked, foreign-owned or world-readable
records are refused.max_records per workspace (default 32, clamped 1..=1024) and
max_age_secs (default 7 days, minimum 1 hour); writes are throttled by
min_interval_ms (default 2000).recovery.restore / recovery.discard / recovery.clear /
recovery.enable / recovery.disable — or [recovery] enabled = false
to turn snapshots off entirely.Open Quick Open (Ctrl+P in the Standard profile, Alt+G o in both profiles)
and press Tab to switch between filename and content search. Content search
is literal (not regex), runs on a worker so the UI thread never walks the
filesystem, and is cancelled/superseded as you keep typing. Results are bounded
by file count, hit count, per-file bytes, total bytes scanned and excerpt size
(see [general] search_*); search_exclude_dirs replaces the built-in
exclusions (.git, target, node_modules, .venv, …). Alt+Enter / F2
opens the secondary action menu for the selected hit.
On launch fm restores the previous session for the same workspace root:
open documents with their cursors, pane layout and recent files. A session
record stores paths and view state only — never terminal buffers, running
processes, LSP execution trust or secrets. It is size-validated before parsing
(1 MiB, at most 256 documents), written atomically into a private state
directory, and a corrupt or future-version record is non-fatal (a status line
is shown and fm starts clean). Unsaved text is not part of a session; see
Private recovery. Disable with [session] enabled = false.
Session restore is skipped in S3 mode.
Every workspace action is a registered command with a stable id usable in
[[keymap.bindings]]: workspace.commands, workspace.quit,
navigation.{quick_open,open_selection,selection_actions},
document.{list,pin,previous,next,reveal,save,save_as,close},
focus.{explorer,editor,preview,terminal,left,right,up,down,cycle},
pane.{explorer,terminal}.{toggle,grow,shrink} (terminal also maximize),
pane.editor.maximize, pane.layout.restore, view.wrap.toggle,
preview.view_mode, recovery.{restore,discard,clear,enable,disable},
lsp.{status,restart,completion,hover,definition,references,symbols,diagnostics}
and diagnostics.{next,previous}. The F8 menu lists the ones available in the
current context, with disabled reasons.
Based on the Catppuccin Mocha color palette with deep blues, soft purples, and warm accents.
Based on Catppuccin Latte for well-lit environments with a clean light background.
Browse AWS S3 buckets directly from the TUI by passing an s3:// URI as the path argument. This mode uses the AWS CLI under the hood — no AWS SDK dependency.
s3://, fm automatically enters S3 browse modeaws s3api list-objects-v2, at most max_entries_per_page, capped at 1000 keys). A Load more... row at the end of a prefix (Enter, l, or a second click) fetches the next page, so prefixes with 100k–1M objects stay responsive. Loading stops at snapshot_max_entries entries per prefix (default 500000) with a status message; a failed or timed-out page keeps the entries already loaded and can be retried. Collapsing and re-expanding a prefix reuses the loaded pages.s3:ListBucket (the same as aws s3 ls)☁ S3 status bar badgey to copy the full s3:// URI of the selected item to clipboard--aws-profile <name> for MFA or role-based authentication/tmp/fm-s3-cache-<pid>/ and cleaned up on exitaws) must be installed and on $PATHaws configure, environment variables, or IAM role)# Browse a bucket root
fm s3://my-bucket
# Browse a specific prefix
fm s3://my-bucket/experiments/run-1/
# Use a named profile
fm s3://ml-data-bucket --aws-profile mfa
src/
├── main.rs # Entry point, CLI parsing, main loop, session/recovery startup
├── app.rs # Application state and logic
├── handler.rs # Key/mouse event dispatch
├── commands.rs # Command registry (ids, titles, context gating)
├── keymap.rs # Standard/Web profiles, bindings, Alt+G prefix routes
├── background.rs # Bounded, generation-aware job/queue primitives
├── background/
│ └── app_jobs.rs # Bounded App worker pool (scans, summaries, S3, clipboard)
├── ui.rs # Layout and rendering
├── tui.rs # Terminal setup/teardown
├── event.rs # Event system (key, mouse, tick, async)
├── config.rs # TOML configuration loading and merging
├── theme.rs # Theme colors and palettes
├── error.rs # Error types
├── text.rs # Document positions (UTF-8 bytes) and display-cell helpers
├── editor.rs # Editor state, undo/redo, find/replace
├── highlighting.rs # Prepared preview loading, line/checkpoint syntax caches
├── preview_content.rs # Syntax highlighting, notebook rendering
├── search.rs # Filename index and bounded content search
├── session.rs # Versioned workspace session persistence
├── recovery.rs # Private recovery snapshots of dirty documents
├── git.rs # Read-only Git status backend
├── diagnostics.rs # Versioned per-server LSP diagnostics state
├── workspace/
│ ├── mod.rs # Workspace aggregate
│ ├── documents.rs # Retained document set, tabs, open dispositions
│ ├── focus.rs # Focus/overlay state machine
│ └── layout.rs # Pane geometry, maximize/restore
├── lsp/
│ ├── mod.rs # Session manager, sync, trust model
│ ├── client.rs # Server lifecycle and initialize handshake
│ ├── transport.rs # Bounded stdio JSON-RPC transport
│ ├── config.rs # [lsp] config and project-local trust rules
│ ├── features.rs # Completion, hover, definition, references, symbols
│ └── positions.rs # UTF-8/UTF-16/UTF-32 position-encoding adapters
├── components/
│ ├── tree.rs # File tree widget with icons
│ ├── preview.rs # Preview pane widget
│ ├── editor.rs # Editor widget (line numbers, cursor, find bar)
│ ├── document_tabs.rs # Retained-document tab strip
│ ├── workspace_chrome.rs # Pane borders, Commands button, chrome
│ ├── command_menu.rs # Searchable command menu (F8)
│ ├── settings.rs # Live Settings tab
│ ├── status_bar.rs # Status bar widget
│ ├── dialog.rs # Modal dialog widget
│ ├── search.rs # Quick Open overlay
│ ├── content_search.rs # Content-search overlay state
│ ├── search_action.rs # Search action menu overlay
│ ├── diagnostics.rs # Diagnostics panel
│ ├── language_features.rs # Completion/hover/references/symbols popups
│ ├── help.rs # Help overlay widget
│ └── terminal.rs # Terminal panel widget
├── fs/
│ ├── tree.rs # Tree data structure, sorting, filtering
│ ├── operations.rs # File CRUD operations
│ ├── save.rs # Bounded, revision-checked safe save policy
│ ├── clipboard.rs # Copy/cut/paste state
│ └── watcher.rs # Filesystem watcher with debounce
├── s3/
│ ├── mod.rs # Module exports
│ ├── backend.rs # Async S3 backend (shells out to `aws` CLI)
│ ├── parser.rs # Parser for `aws s3api list-objects-v2` JSON pages
│ └── types.rs # S3Path, S3Entry, S3Config types
└── terminal/
├── mod.rs # Module exports, PtyProcess struct
├── pty.rs # PTY creation and async I/O
└── emulator.rs # VTE-based terminal emulator
scripts/ # install.sh, terminal-workspace PTY harness, fake LSP server
tools/terminal-tests/ # xterm.js + Playwright browser-terminal suite
# Run tests
cargo test
# Run with clippy (the local gate also checks all targets)
cargo clippy -- -D warnings
cargo clippy --all-targets -- -D warnings
# Format check
cargo fmt --check
# Release build
cargo build --release
# Run in development
cargo run -- .
The terminal-workspace acceptance matrix runs against a release binary:
cargo build --release
# PTY scenarios — 13 automated runs (workflow, resize, TERM variants,
# nested tmux, feature flags, missing/fake LSP, external save, crash
# recovery, corrupt records, missing git, git markers). Exits nonzero on
# any failure or a missing harness/binary — never a silent skip.
python3 scripts/test-terminal-workspace.py
# Browser-terminal suite — xterm.js + ws fixture served locally, driven by
# Playwright: paste paths, browser-reserved shortcut exclusions, copy
# fallback, resize, full workflow. `npm ci` first if node_modules is absent.
npm --prefix tools/terminal-tests ci
npm --prefix tools/terminal-tests test
# All of the above plus Rust gates in one place, nonzero exit on any
# mandatory failure:
scripts/check-terminal-workspace.sh
Live SSH/Jupyter/Kubeflow deployment remains a manual boundary: controlled PTY/tmux transport evidence is not a production-deployment claim.
MIT License. See LICENSE for details.
NguyenSiTrung/FileManagerTUI is a public repo on GitHub by NguyenSiTrung. ⚡ A fast, keyboard-driven terminal file manager built in Rust. Dual-pane tree+preview, Vim keybindings, fuzzy finder, embedded terminal, inline editor, and Catppuccin themes.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-10-05. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Reverse engineer anything with agents, from app behavior down to native binaries.

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
💥 Blazing fast terminal file manager written in Rust, based on async I/O.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

Cross-platform, fully-offline Vietnamese/English text-to-speech desktop workstation powered by VieNeu-TTS v3 Turbo (ONNX/CUDA, Voice Cloning, EPUB Audiobooks, PySide6/QML)

Wrap Gemini CLI, ChatGPT Codex, Claude Code, Qwen Code, iFlow as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 2.5 Pro, GPT 5, Claude, Qwen model through API
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/NguyenSiTrung/FileManagerTUITake My Repo has not tested this on your machine. Requirements come from the project's own documentation.