Skip to content
Back to search

tamio

Native SSH client for macOS: Ghostty terminal, dual-pane SFTP, live server status, E2EE iCloud sync and an MCP server for agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/missuo--tamio/badge.svg)](/listings/missuo--tamio)

HTML

<a href="/listings/missuo--tamio"><img src="/api/listings/missuo--tamio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

With [Homebrew](https://brew.sh):

brew install --cask owo-network/brew/tamio

Or download the disk image from [Releases](https://github.com/missuo/tamio/releases/latest). Tamio needs macOS 14 or later, and updates itself.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 138 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Tamio
  2. A native SSH client for macOS: a Ghostty terminal, a dual-pane SFTP browser,
  3. live status for every server, end-to-end encrypted iCloud sync, and an MCP
  4. server so AI agents can work across your hosts with your approval.
  5. Tamio is in early development. The plan is in [DESIGN.md](./DESIGN.md). An
  6. iOS version is planned, but work on it has not started yet.
  7. ![Platform](https://img.shields.io/badge/platform-macOS%2014%2B-lightgrey)
  8. ![Swift](https://img.shields.io/badge/Swift-6.2-orange)
  9. [![License](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
  10. ## Install
  11. With [Homebrew](https://brew.sh):
  12. ```sh
  13. brew install --cask owo-network/brew/tamio
  14. ```
  15. Or download the disk image from [Releases](https://github.com/missuo/tamio/releases/latest).
  16. Tamio needs macOS 14 or later, and updates itself.
  17. ## Features
  18. ### Agents (MCP)
  19. - **A built-in MCP server.** Claude Code, Codex and any other MCP client can
  20. work on your servers through Tamio. Settings › MCP sets up Claude Code, Codex
  21. and the Tamio skill in one click.
  22. - **What agents can do:**
  23. - see your servers and their live CPU, memory, disk, load and traffic;
  24. - run commands or saved snippets on one server or many at once;
  25. - add or change servers, SSH keys, snippets and port forwards;
  26. - start and stop port forwards.
  27. - **Every server operation leaves a history.** Each command an agent runs and
  28. each change it makes is recorded on that server's Activity: which agent, on
  29. which Mac, what it ran, and what came back. Agents also log what they did
  30. outside Tamio (their own `ssh`, `scp`, a deploy).
  31. - **One entry per task, not per command.** An agent names the goal of each
  32. step, such as "Install nginx", and every step toward it (the repository,
  33. `apt update`, the install, its config) is kept as one entry, with each step
  34. and its result under it. The next agent sees what was done at a glance.
  35. - **Filter by server.** Settings › MCP shows the activity of every server, or of
  36. the one you pick.
  37. - **The history outlives the session.** An agent's session may be lost when you
  38. switch agents, swap devices or change computers. The record stays with the
  39. server, and syncs across your Macs, so the next agent knows what the last one
  40. did there.
  41. ### Security
  42. - **Agents never see a secret.** No tool returns a password, a private key or a
  43. passphrase. An agent can add a key, or have Tamio generate one, and gets back
  44. only the public half.
  45. - **You approve first.** Every command, change and port forward an agent asks
  46. for waits for you, showing exactly what will run and where. Allow it once,
  47. for an hour, or always, for an agent left to work on its own; Settings › MCP
  48. lists the agents always allowed, and revokes them.
  49. - **Only you can reach it.** The MCP server listens on a Unix socket that only
  50. your own user account can open. It doesn't use a network port.
  51. - **Encrypted on disk.** Servers and identities are stored encrypted, under a key
  52. kept in your Keychain.
  53. - **End-to-end encrypted sync.** Data is encrypted on your Mac, under a
  54. passphrase only your devices know, before it goes to iCloud. Apple cannot read
  55. it.
  56. - **Host keys are checked.** A server's key is trusted once, and a changed key
  57. is refused.
  58. ### Servers and terminal
  59. - A fast terminal, built on [Ghostty](https://ghostty.org).
  60. - Servers with labels, groups and tags; a password or an SSH key to sign in.
  61. - Identities: paste a key, load one from a file, or generate an Ed25519 key. A
  62. private key is never shown again once saved.
  63. - Snippets for the commands you run often, and local and remote port forwards.
  64. ### Live status
  65. - A Home card for every server with live CPU, memory and disk, its operating
  66. system's logo, and a flag for labels such as `JP Tokyo`.
  67. - Details for each server: overview, processes, containers and agent activity.
  68. ### Files (SFTP)
  69. - Two panes, this Mac and a server, each switchable to any server.
  70. - Drag files between the panes, from Finder, or out to Finder. Folders go whole.
  71. - A transfer queue with progress, speed, time left, cancel and retry, and a
  72. notification when a transfer ends while Tamio is in the background.
  73. ### iCloud sync
  74. - On unless you turn it off, so your servers and what agents did on them are
  75. never lost with a Mac.
  76. - Servers, identities, snippets, port forwards, known host keys and agent
  77. activity stay the same on all your Macs, each kind with its own switch.
  78. - Tamio makes the passphrase and iCloud Keychain carries it, so your other Macs
  79. sync by themselves. Settings shows it, for a device without iCloud Keychain.
  80. ### App
  81. - Updates itself with Sparkle: a new version shows at the bottom of the
  82. sidebar, with its release notes.
  83. - Light and dark appearance.
  84. ## Build from source
  85. Needs Xcode 26 or later.
  86. ```sh
  87. git clone https://github.com/missuo/tamio.git
  88. cd tamio
  89. bash Workflow/Scripts/build-macos.sh # Debug, signed ad hoc
  90. ```
  91. Or open `App.xcworkspace` and run the **Tamio** scheme. After editing
  92. `Application/Tamio/project.yml`, run `xcodegen generate` in `Application/Tamio`.
  93. Tests:
  94. ```sh
  95. swift test --package-path Foundation/TamioModule
  96. swift test --package-path Foundation/TamioTerminal
  97. swift test --package-path Foundation/MachineStatus
  98. ```
  99. Releases are signed and notarized by GitHub Actions when a `v<version>` tag is
  100. pushed (`.github/workflows/release.yml`).
  101. ## Credits
  102. - [mizorewww/catussh](https://github.com/mizorewww/catussh)
  103. - [Lakr233/Rayon](https://github.com/Lakr233/Rayon)
  104. ## License
  105. [MIT](./LICENSE). Third-party licenses are listed in [Resources/LICENSE](./Resources/LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.