Netcatty/README.ja-JP.md

Netcatty

🔥 AI 搭載の SSH クライアント、SFTP ブラウザ & ターミナルマネージャー 🚀
netcatty.app

Electron、React、xterm.js で構築された機能豊富な SSH ワークスペース。
🔥 内蔵 AI Agent · 分割ターミナル · Vault ビュー · SFTP ワークフロー · カスタムテーマ — すべてが一つに。

   

 

English · 简体中文 · 繁體中文 · 日本語

---

---

🔥 Catty Agent — あなたの IT 運用 AI パートナー

🚀 AI で日常の IT 運用作業を加速。 Catty Agent はサーバー環境を理解し、コマンドを実行し、自然な会話で複数ホストの複雑な操作をこなす内蔵 AI アシスタントです。

🔥 Catty Agent にできること

• 🚀 自然言語でサーバー管理 — コマンドを暗記せず、必要なことを話しかけるだけ
• 🔥 リアルタイムサーバー診断 — 会話を通じてステータス確認、ログ調査、リソース監視
• 🚀 マルチホスト連携 — 複数サーバーのタスクを同時にコーディネート
• 🔥 インテリジェントなコンテキスト認識 — サーバー環境を理解し、的確な回答を提供
• 🚀 ワンステップで複雑な操作 — クラスター構築、サービスデプロイなど簡単な指示で実行

🎬 AI の動作デモ

🔥 シングルホスト — インテリジェントなサーバー診断

Catty Agent にサーバーの健全性チェックを依頼すると、適切なコマンドを実行し、出力を分析して数秒で明確なサマリーを提示します。

🚀 マルチホスト — Docker Swarm クラスターのセットアップ

1 つの会話で 2 台のサーバーをまたいで Docker Swarm クラスターをオーケストレーションする Catty Agent をご覧ください。初期化、トークン交換、ノード参加まですべてこなします — あなたは望む結果を伝えるだけ。

---

目次

• 🔥 Catty Agent — AI パートナー
• Netcatty とは
• なぜ Netcatty
• 機能
• スクリーンショット
  • メインウィンドウ
  • Vault ビュー
  • モニタリングビュー
  • 分割ターミナル
• 対応ディストリビューション
• はじめに
• ビルドとパッケージ
• 技術スタック
• コントリビューション
• コントリビューター
• Star 履歴
• ライセンス

---

Netcatty とは

Netcatty は、複数のリモートサーバーを効率的に管理する必要がある開発者、システム管理者、DevOps エンジニア向けに設計された、モダンなクロスプラットフォーム SSH クライアントおよびターミナルマネージャーです。

• Netcatty は PuTTY、Termius、SecureCRT、macOS Terminal.app の代替となる SSH 接続ツール
• Netcatty は デュアルペインのファイルブラウザを備えた強力な SFTP クライアント
• Netcatty は 分割ペイン、タブ、セッション管理を備えたターミナルワークスペース
• Netcatty は SSH、ローカルターミナル、Telnet、Mosh、シリアル接続をサポートします（利用可能な場合）
• Netcatty は シェルの代替ではありません — SSH/Telnet/Mosh またはローカル/シリアルセッション経由でシェルに接続します

---

なぜ Netcatty

複数サーバーを日常的に扱うなら、Netcatty は「スピード」と「流れ」を重視した作りになっています：

• ワークスペース中心 — 分割ペイン + タブ + セッション復元で常時使うワークフローに対応
• Vault の整理 — グリッド/リスト/ツリー表示、高速検索、ドラッグしやすいワークフロー
• 本格的な SFTP — 内蔵エディタ + ドラッグ＆ドロップ + スムーズなファイル操作

---

機能

🗂️ Vault

• 複数ビュー — グリッド / リスト / ツリー
• 高速検索 — ホストやグループを素早く見つける

🖥️ ターミナルワークスペース

• 分割ペイン — 水平・垂直分割でマルチタスク
• セッション管理 — 複数の接続を並行して扱う
• インライン画像 — リモートプログラムが出力する Kitty グラフィックス、SIXEL、iTerm インライン画像を描画
• アーカイブショートカット — Linux セッションでは、出力された .tar、.tar.gz/.tgz、.tar.bz2/.tbz2、.tar.xz、.zip の名前を Ctrl/Cmd+クリックすると、アーカイブの絶対パスを含む展開コマンドがカーソル位置に挿入されます（入力済みの文字は残ります）。Enter で実行します。カレントディレクトリからの相対名にはディレクトリ追跡（OSC 7、ツールバーの Configure directory tracking）が必要です。絶対パスは常に対象です。Windows、WSL、macOS のセッションは対象外です。

📁 SFTP + 内蔵エディタ

• ファイル作業 — ドラッグ＆ドロップでアップロード/ダウンロード
• その場で編集 — 内蔵エディタで小さな修正を素早く

🎨 パーソナライズ

• カスタムテーマ — UI の見た目を好みに調整
• キーワードハイライト — ターミナル出力の強調表示ルールをカスタマイズ

---

スクリーンショット

メインウィンドウ

メインウィンドウは、長時間の SSH 作業を前提に設計されています。セッション、ナビゲーション、主要ツールへ素早くアクセスできます。

Vault ビュー

作業に合わせて見え方を切り替え：グリッドで全体像、リストでスキャン、ツリーで整理と階層ナビゲーション。

モニタリングビュー

CPU、メモリ、ディスク、ネットワーク、レイテンシーを確認でき、対応する環境では GPU の詳細も表示されます。表示する列の選択、列幅や更新設定の調整ができ、監視対象のホストから直接ターミナルを開くこともできます。

分割ターミナル

分割ペインで複数のサーバー/タスクを同時に扱えます（例：デプロイ + ログ + 監視）。

---

対応ディストリビューション

Netcatty は接続したホストの OS を検出し、ホスト一覧でアイコンとして表示します：

はじめに

ダウンロード

GitHub Releases からお使いのプラットフォームに対応した最新版をダウンロードしてください。

OS	サポート状況
macOS	Universal (x64 / arm64)
Windows	x64 / arm64
Linux	x64 / arm64

または GitHub Releases ですべてのリリースを参照してください。

コード署名とプライバシー

Netcatty は SignPath Foundation のオープンソースプログラムに申請中です。 承認後、対象となる Windows リリース成果物には Free code signing provided by SignPath.io, certificate by SignPath Foundation が使用されます。詳細は コード署名ポリシーと プライバシーポリシーをご覧ください。申請と導入が完了するまで、 Windows リリースは未署名の場合があります。

Windows のポータブルデータ： Netcatty を終了し、Netcatty.exe（zip 版）またはポータブル版ランチャーと同じ場所に data フォルダーを作成してください。次回起動時から、Netcatty はデータをこのフォルダーに保存します。保存済みのパスワードと秘密鍵は、作成した Windows ユーザーによって引き続き保護されます。別のコンピューターまたは Windows ユーザーへ移動した場合は、これらの機密情報を再入力する必要があります。

Windows でフォルダーを Netcatty で開く： インストール版では、エクスプローラーのフォルダーおよびフォルダー背景のコンテキストメニューに Open in Netcatty が追加されます。選択すると、そのフォルダーでローカルターミナルが開きます。Windows 11 では、先に その他のオプションを表示 を選択してください。設定 → システム → Windows Explorer からメニューの表示／非表示を切り替えられます。ZIP 版とポータブル版では、既定ではこのメニューは追加されません。

macOS ユーザーへ： 現在のリリースはコード署名と notarization が行われている想定です。Gatekeeper の警告が出る場合は、GitHub Releases から最新版の公式ビルドを取得しているか確認してください。

Scoop（Windows x64、コミュニティ管理）

Scoop をインストール済みの場合、コミュニティが管理する lemon バケット から Netcatty をインストールできます。このバケットは Netcatty の公式 GitHub Releases からインストーラーをダウンロードします：

scoop bucket add lemon https://github.com/hoilc/scoop-lemon
scoop install lemon/netcatty

更新またはアンインストールの前に Netcatty を終了してください：

scoop update
scoop update netcatty

アンインストールする場合：

scoop uninstall netcatty

これはサードパーティ製パッケージであり、Netcatty の公式バケットではありません。更新は GitHub Releases より遅れる場合があります。現在は x64 のみに対応しています。設定は %APPDATA%\netcatty に保存され、更新や通常のアンインストール後も残ります。scoop uninstall netcatty --purge はこれらの設定も削除します。この方法でインストールした場合は、Scoop で更新を管理してください。

Nix / NixOS

Netcatty は Nix および NixOS ユーザー向けに、公式 Linux AppImage リリースをラップした flake を提供しています：

nix run github:binaricat/Netcatty

宣言型インストールには、Netcatty flake を input として追加し、NixOS または Home Manager のパッケージリストで inputs.netcatty.packages.${pkgs.system}.default を使用してください。

前提条件

• Node.js 18+ と npm
• macOS、Windows 10+、または Linux

開発

# リポジトリをクローン
git clone https://github.com/binaricat/Netcatty.git
cd Netcatty

# 依存関係をインストール
npm install

# 開発モードを起動（Vite + Electron）
npm run dev

---

ビルドとパッケージ

# 本番用ビルド
npm run build

# 現在のプラットフォーム用にパッケージ
npm run pack

# 特定のプラットフォーム用にパッケージ
npm run pack:mac     # macOS (DMG + ZIP)
npm run pack:win     # Windows (NSIS インストーラー)
npm run pack:linux   # Linux (AppImage + DEB + RPM)

---

技術スタック

カテゴリ	テクノロジー
フレームワーク	Electron 40
フロントエンド	React 19, TypeScript
ビルドツール	Vite 7
ターミナル	xterm.js 5
スタイリング	Tailwind CSS 4
SSH/SFTP	ssh2, ssh2-sftp-client
PTY	node-pty
アイコン	Lucide React

---

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を提出してください。

1. リポジトリをフォーク
2. フィーチャーブランチを作成 (git checkout -b feature/amazing-feature)
3. 変更をコミット (git commit -m 'Add some amazing feature')
4. ブランチにプッシュ (git push origin feature/amazing-feature)
5. Pull Request をオープン

アーキテクチャの概要とコーディング規約については AGENTS.md を参照してください。

---

コントリビューター

貢献してくださったすべての方に感謝します！

---

ライセンス

このプロジェクトは GPL-3.0 ライセンス の下でライセンスされています - 詳細は LICENSE ファイルをご覧ください。

---

Star 履歴

---

❤️ を込めて作成 by binaricat