Noden Documentation

A native macOS SSH & SFTP client with a dual-pane file commander and an AI assistant. This guide covers everything from your first connection to licensing.

Getting started

Noden runs on macOS 13 (Ventura) or later. After downloading the DMG, drag Noden into your Applications folder and open it. On first launch macOS may ask permission for Noden to read its own keychain item — this is expected (see Privacy & security).

1. Open Noden. The left sidebar lists your saved connections (empty at first).
2. Click New Connection at the bottom of the sidebar, or press ⌘N.
3. Enter a host, port, and username, then connect. Your session opens as a tab.

Install with Homebrew

Noden is available from the official Useroam Teknoloji Homebrew tap. Install it with one command:

brew install --cask useroamteknoloji/tap/noden

To update or uninstall Noden later:

brew upgrade --cask noden
brew uninstall --cask noden

The tap is public at github.com/useroamteknoloji/homebrew-tap.

Connections

Adding and editing

Each connection stores a name, host, port, username and authentication method. Edit any connection later by selecting it and choosing Edit. Free accounts can save up to 5 connections; Noden Pro removes the limit.

SSH keys — automatic

Noden reads the keys already in your ~/.ssh folder (ed25519 and ecdsa). If your server accepts one of your existing keys, there's nothing to configure. Passphrase-protected keys are unlocked through the macOS Keychain.

Import from ~/.ssh/config

Already keep your servers in an SSH config file? Import them in one step: Noden reads ~/.ssh/config and turns each Host entry into a saved connection.

Encrypted backup & import

Export every connection to a single password-encrypted file for safekeeping or to move to another Mac, then import it back at any time. Secrets are encrypted with your chosen password — never stored in plain text.

The terminal

Noden's terminal is a full xterm-compatible emulator. Open as many sessions as you like; each becomes a tab.

Tabs vs. grid

Use the layout switch in the toolbar to view a single session (tabs) or several at once in a grid. In grid mode choose 1–4 columns to watch multiple servers side by side. Click a cell to give it keyboard focus.

Local terminal

Press ⌘T for a local shell on your Mac — handy for running scp, editing files, or working locally without leaving the app.

Appearance

Open Settings (⌘,) to pick a colour theme and monospaced font. Adjust text size on the fly with ⌘+, ⌘- and ⌘0. The Terminal settings tab also controls cursor style, blink, scrollback size and the bell.

SFTP file commander

Every SSH connection includes a dual-pane file manager. Switch a session between terminal and files using the toolbar's Terminal / Files selector.

• Local and remote, side by side. Browse your Mac on one side and the server on the other.
• Drag & drop to transfer files in either direction.
• Edit in place. Open a remote file in your favourite Mac editor; Noden syncs your changes back automatically when you save.
• Separate window. Pop the file commander out into its own window to keep it open next to a terminal.

AI assistant

Open the assistant with ⇧⌘A or the wand icon in the toolbar. Describe what you want in plain English and Noden proposes the exact shell commands — then runs them on the active server with one click, with a guard that flags dangerous operations before they execute.

Noden brain, or bring your own

By default the assistant uses Noden's own tuned model. Prefer your own provider? Add a key for OpenAI, Groq, OpenRouter, or point it at a local model — Noden's SSH-aware reasoning rides along either way. The AI assistant is a Pro feature.

Command history

Toggle the history panel with ⌘Y. Noden records the commands you run across sessions so you can find and reuse them. Each row can be copied or run again with a single click, and the text is fully selectable. Free accounts keep the most recent 50 commands; Pro keeps your full, unlimited history.

Keyboard shortcuts

Pro & licensing

Noden is free to use with up to 5 saved connections and the last 50 commands of history. Noden Pro unlocks unlimited connections, full command history, and the AI assistant.

Two ways to buy

• Direct download (this site): a yearly license. After purchase you receive a license key by email. Enter it in Noden → Noden Pro and click Activate.
• Mac App Store: an auto-renewing yearly subscription managed by Apple.

Managing your license

Bought from this site? Sign in to your account with your email — no password, we send a one-time link — to view your license key, renewal date, and to request a refund within the eligibility window.

Privacy & security

Passwords, key passphrases and private keys live only in your Mac's Keychain — never on our servers. File contents are never collected.