From 2bbc8918a85ab24e95fe4f475da8bb06dcbef558 Mon Sep 17 00:00:00 2001
From: Kaede Akino <i@akinokae.de>
Date: Tue, 20 Oct 2026 14:14:07 +0800
Subject: [PATCH] docs: add project README

---
 README.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..2bb9620f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,86 @@
+<p align="center">
+  <a href="https://termind.akinokaede.com">
+    <img src="https://raw.githubusercontent.com/AkinoKaede/com.akinokaede.termind/7d1f97782333bd1e6c6fb0c1a3bd391af5ef4905/public/brand_mark.svg" alt="Termind logo" width="128" height="128">
+  </a>
+</p>
+
+<h1 align="center">Termind</h1>
+
+<p align="center">
+  AI-driven remote workspace for Mac, iPhone, and iPad
+</p>
+
+<p align="center">
+  <a href="https://termind.akinokaede.com">Website</a>
+  &middot;
+  <a href="https://apps.apple.com/app/apple-store/id6805856690">App Store</a>
+  &middot;
+  <a href="LICENSE">License</a>
+</p>
+
+## Features
+
+Termind brings terminals, remote files, server metrics, and a controllable AI
+assistant together in one app.
+
+- **Remote connections.** Connect with SSH, Mosh, Eternal Terminal, and Telnet,
+  plus serial connections on Mac.
+- **Workspaces and persistent sessions.** Organize terminals and SFTP sessions in
+  multi-pane workspaces on Mac. Integrate with Herdr, tmux, Zellij, or zmx to
+  return to remote sessions after disconnecting.
+- **Visual SFTP.** Browse, preview, and manage remote files across multiple
+  connections, or upload files by dragging them into the terminal.
+- **Host management.** Organize saved hosts, identities, known hosts, and
+  connection settings in one place.
+- **AI, commands, and snippets.** Use your own provider and API key with an
+  Assistant whose actions you control. Generate commands without automatically
+  running them, and save reusable snippets.
+- **MCP integrations.** Connect external MCP tools to the Assistant. The built-in
+  local MCP service on Mac also exposes SSH and SFTP tools to other AI clients,
+  with per-tool controls and an audit trail.
+- **Agentless Linux monitoring.** Monitor servers over SSH without installing a
+  monitoring agent. Track CPU, memory, disk, network, GPU, filesystem, and process
+  metrics.
+- **Network tools.** Set up SSH port forwarding, with multi-connection support on
+  Mac. Connect through built-in Tailscale and wake devices on your local network
+  with Wake-on-LAN.
+- **Storage and sync.** Store app data locally with optional iCloud sync across
+  devices, and protect credentials with Apple Keychain.
+
+The apps support **macOS 15+, iOS 18+, and iPadOS 18+**. Mosh and Eternal Terminal
+require their corresponding server software. Mosh also requires reachable UDP
+ports and is not available for hosts managed by built-in Tailscale.
+
+## Preview
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/AkinoKaede/com.akinokaede.termind/7d1f97782333bd1e6c6fb0c1a3bd391af5ef4905/assets/captures/en/mac-14/workspace_window.png" alt="Termind macOS window with two SSH terminals and an SFTP browser" width="960">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/AkinoKaede/com.akinokaede.termind/7d1f97782333bd1e6c6fb0c1a3bd391af5ef4905/assets/captures/en/ipad-15/assistant.png" alt="Termind AI Assistant on iPad investigating a server issue" width="960">
+</p>
+
+## Development
+
+### Build from source
+
+```sh
+git clone https://github.com/AkinoKaede/Termind.git
+cd Termind
+open Termind.xcodeproj
+```
+
+### Local configuration
+
+Firebase and RevenueCat setup is optional; see [local service configuration](Configuration/README.md).
+
+### Website and assets
+
+The [website and assets](https://github.com/AkinoKaede/com.akinokaede.termind) live
+in an optional submodule. Follow its README for setup and development; native app
+builds do not require it.
+
+# License
+
+This repository is licensed under the [GNU General Public License v3.0](LICENSE) (GPL-3.0-only).