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](#catty-agent)
- [What is Netcatty](#what-is-netcatty)
- [Why Netcatty](#why-netcatty)
- [Features](#features)
- [Screenshots](#screenshots)
- [Main Window](#main-window)
- [Vault Views](#vault-views)
- [Split Terminals](#split-terminals)
- [Supported Distros](#supported-distros)
- [Getting Started](#getting-started)
- [Build & Package](#build--package)
- [Tech Stack](#tech-stack)
- [Contributing](#contributing)
- [Contributors](#contributors)
- [Star History](#star-history)
- [License](#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
- **Inline images** โ render Kitty graphics, SIXEL and iTerm inline images from remote programs
### ๐ 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](https://github.com/binaricat/Netcatty/releases/latest).
| OS | Support |
| :--- | :--- |
| **macOS** | Universal (x64 / arm64) |
| **Windows** | x64 / arm64 |
| **Linux** | x64 / arm64 |
Or browse all releases at [GitHub Releases](https://github.com/binaricat/Netcatty/releases).
### Code signing and privacy
Netcatty is applying to the SignPath Foundation open-source program. Once
approved, covered Windows release artifacts will use **Free code signing provided by SignPath.io, certificate by SignPath Foundation**.
See the [code signing policy](CODE_SIGNING_POLICY.md) and
[privacy policy](PRIVACY.md). Windows releases may remain unsigned until the
application and integration are complete.
> **Windows portable data:** Exit Netcatty, then create a folder named `data` beside `Netcatty.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.
> **Open folders in Netcatty on Windows:** The installed version adds **Open in Netcatty** to Explorer's folder context menu and folder-background context menu. It opens a local terminal in that folder. On Windows 11, choose **Show more options** first. Turn the menu off or on in **Settings โ System โ Windows Explorer**. ZIP and portable versions do not add this menu by default.
> **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:
```bash
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
```bash
# 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
```bash
# 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.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
See [agents.md](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](LICENSE) file for details.
---
# Star History
---
