* fix SFTP transfer throughput regression * fix: address Codex review on PR #2429 * fix resumable transfer review findings * fix remaining resumable transfer review findings * fix: address Codex review on PR #2429 * fix(sftp): harden resumable range fallback and channel cleanup Truncate staged sparse tails to the contiguous checkpoint before stream fallback or pause, always release isolated download channels on cancel and failed fast paths, and stabilize concurrency unit tests. * fix(sftp): abort range transfers on isolated channel errors Attach a temporary SFTP error listener during concurrent range copies so channel resets reject cleanly instead of crashing main, and force-publish the contiguous checkpoint when pausing. * fix(sftp): never truncate S2S temp source on upload fallback stagedLocalPath during SFTP→SFTP upload is the fully-downloaded temp source, not a partial target. Only truncate partial download/local targets and remote .part staging files. * fix(sftp): truncate direct-download sparse tails on range fallback Direct SFTP→local resumable transfers keep resumeStage "direct" and never copied targetType onto the transfer object, so prepareStreamFallback skipped truncating the staged .part after out-of-order range failure. A later stream pause could then stat the oversized sparse file and advance past holes. Treat any staged local path outside the S2S upload phase as a partial target, persist target metadata on the transfer, and fix the sparse-tail test to assert against the real staged path. * fix(sftp): always end isolated upload channel on open failures uploadFileResumableFast assumed callers only saw throws after the isolated channel was already ended, but a failed local fs.open left the channel open while the catch path cleared fastSftp without disposing it. End the channel in a single finally covering local open, remote open, and range transfer. * test(sftp): stabilize local-open channel cleanup regression Make the missing-source upload case delete the file only after the isolated channel opens, and keep stream-fallback errors handled so the suite asserts channel disposal without unhandled stream ENOENTs. * fix resumable transfer fallback safety * fix(sftp): allow cancel while resumable OPEN is in flight Install transfer.abort before awaiting local/remote handles so cancel ends the isolated channel if the server stalls SFTP OPEN. Covers upload and download fast paths, with a regression test for stalled upload OPEN. * fix(sftp): detect same-size source rewrites via content samples Metadata-only checks can miss in-place rewrites when mtime/ctime do not advance. Sample SHA-256 digests through the open local handle before range upload and re-check after, and do the same path-level check for stream fallback. Harden the regression test by freezing utimes after rewrite. --------- Co-authored-by: netcatty-cursor-bot <41898282+github-actions[bot]@users.noreply.github.com>
Netcatty
🔥 AI-Powered SSH Client, SFTP Browser & Terminal Manager 🚀
netcatty.app
A beautiful, feature-rich SSH workspace built with Electron, React, and xterm.js.
🔥 Built-in AI Agent · Split terminals · Vault views · SFTP workflows · Custom themes — all in one.
🔥 Catty Agent — Your IT Ops AI Partner
🚀 Boost your IT ops daily work with AI power. Catty Agent is the built-in AI assistant that understands your servers, executes commands, and handles complex multi-host operations — all through natural conversation.
🔥 What can Catty Agent do?
- 🚀 Natural language server management — just tell it what you need, no more memorizing commands
- 🔥 Real-time server diagnostics — check status, inspect logs, monitor resources through conversation
- 🚀 Multi-host orchestration — coordinate tasks across multiple servers simultaneously
- 🔥 Intelligent context awareness — understands your server environment and provides tailored responses
- 🚀 One-click complex operations — set up clusters, deploy services, and more with simple instructions
🎬 AI in Action
🔥 Single Host — Intelligent Server Diagnostics
Ask Catty Agent to check a server's health, and it runs the right commands, analyzes the output, and gives you a clear summary — all in seconds.
🚀 Multi-Host — Docker Swarm Cluster Setup
Watch Catty Agent orchestrate a Docker Swarm cluster across two servers in one conversation. It handles the init, token exchange, and node joining — you just tell it what you want.
Contents
- 🔥 Catty Agent — AI Partner
- What is Netcatty
- Why Netcatty
- Features
- Screenshots
- Supported Distros
- Getting Started
- Build & Package
- Tech Stack
- Contributing
- Contributors
- Star History
- License
What is Netcatty
Netcatty is a modern SSH client and terminal manager for macOS, Windows, and Linux, designed for developers, sysadmins, and DevOps engineers who need to manage multiple remote servers efficiently.
- Netcatty is an alternative to PuTTY, Termius, SecureCRT, and macOS Terminal.app for SSH connections
- Netcatty is a powerful SFTP client with dual-pane file browser
- Netcatty is a terminal workspace with split panes, tabs, and session management
- Netcatty supports SSH, local terminal, Telnet, Mosh, and Serial connections (when available)
- Netcatty is not a shell replacement — it connects to shells via SSH/Telnet/Mosh or local/serial sessions
Why Netcatty
If you regularly work with a fleet of servers, Netcatty is built for speed and flow:
- Workspace-first — split panes + tabs + session restore for “always-on” workflows
- Vault organization — grid/list/tree views with fast search and drag-friendly workflows
- Serious SFTP — built-in editor + drag & drop + smooth file operations
Features
🗂️ Vault
- Multiple views — grid / list / tree
- Fast search — locate hosts and groups quickly
🖥️ Terminal Workspaces
- Split panes — horizontal and vertical splits for multi-tasking
- Session management — run multiple connections side-by-side
📁 SFTP + Built-in Editor
- File workflows — drag & drop uploads/downloads
- Edit in place — built-in editor for quick changes
🎨 Personalization
- Custom themes — tune the app appearance to your taste
- Keyword highlighting — customize highlight rules for terminal output
Screenshots
Main Window
The main window is designed for long-running SSH workflows: quick access to sessions, navigation, and core tools in one place.
Vault Views
Organize and navigate your hosts using the view that best fits the moment: grid for overview, list for scanning, tree for structure.
Split Terminals
Split panes help you monitor multiple servers/services at the same time (deploy + logs + metrics) without juggling windows.
Supported Distros
Netcatty automatically detects and displays OS icons for connected hosts:
Getting Started
Download
Download the latest release for your platform from GitHub Releases.
| OS | Support |
|---|---|
| macOS | Universal (x64 / arm64) |
| Windows | x64 / arm64 |
| Linux | x64 / arm64 |
Or browse all releases at GitHub Releases.
Windows portable data: Exit Netcatty, then create a folder named
databesideNetcatty.exe(zip build) or beside the portable launcher. Netcatty will store its profile there on the next launch. Saved passwords and private keys remain protected by the Windows user account that created them, so they must be re-entered after moving the folder to another computer or Windows account.
macOS Users: Current releases are expected to be code-signed and notarized. If Gatekeeper still warns, make sure you downloaded the latest official build from GitHub Releases.
Nix / NixOS
Netcatty provides a flake that wraps the official Linux AppImage release for Nix and NixOS users:
nix run github:binaricat/Netcatty
For declarative installs, add the Netcatty flake as an input and use inputs.netcatty.packages.${pkgs.system}.default in your NixOS or Home Manager package list.
Prerequisites
- Node.js 18+ and npm
- macOS, Windows 10+, or Linux
Development
# Clone the repository
git clone https://github.com/binaricat/Netcatty.git
cd Netcatty
# Install dependencies
npm install
# Start development mode (Vite + Electron)
npm run dev
Build & Package
# Build for production
npm run build
# Package for current platform
npm run pack
# Package for specific platforms
npm run pack:mac # macOS (DMG + ZIP)
npm run pack:win # Windows (NSIS installer)
npm run pack:linux # Linux (AppImage + DEB + RPM)
Tech Stack
| Category | Technology |
|---|---|
| Framework | Electron 40 |
| Frontend | React 19, TypeScript |
| Build Tool | Vite 7 |
| Terminal | xterm.js 5 |
| Styling | Tailwind CSS 4 |
| SSH/SFTP | ssh2, ssh2-sftp-client |
| PTY | node-pty |
| Icons | Lucide React |
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See agents.md for architecture overview and coding conventions.
Contributors
Thanks to all the people who contribute!
License
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
Star History
Made with ❤️ by binaricat