A neoserver:// link, one click, and NeoServer automatically wakes up, connects to the server, and opens the terminal right where you want it— maybe a specific machine, a certain tmux session, or a specific directory.

Save it to Safari favorites, Notes, a desktop icon, or Siri Shortcuts, or AirDrop it to a colleague, it just works.

1. How to write terminal links

All terminal links look like this:

neoserver://terminal?host=<Server>&port=<Port>&user=<User>&tmuxName=<tmuxSession>&zellijName=<zellijSession>&workdir=<Directory>

⚠️ tmuxName / zellijName / workdir can only have one filled in. If multiple are provided, only tmuxName is recognized, followed by zellijName, and finally workdir.

Just copy and modify it to fit your needs:

# Simplest: only provide host
neoserver://terminal?host=1.2.3.4

# Specify port and user
neoserver://terminal?host=1.2.3.4&port=2222&user=deploy

# Connect and jump straight into the main tmux session
neoserver://terminal?host=1.2.3.4&user=root&tmuxName=main

# Connect and jump straight into the dev zellij session
neoserver://terminal?host=1.2.3.4&user=root&zellijName=dev

# Connect and automatically cd to the logs directory
neoserver://terminal?host=1.2.3.4&user=root&workdir=/var/log/nginx

2. After connecting, where will the terminal land

This is the most useful part of terminal links—filling in different parameters determines where the terminal opens after connecting:

Why distinguish between these three?

• tmux / zellij sessions: If the network drops, the App is closed, or you reconnect from another phone, the session remains and processes aren't lost. Sharing a server's tmux session with a colleague allows both of you to enter the same screen and troubleshoot together.
• Directory: Instead of manually typing cd /opt/app/logs every time you connect, let the link drop you right there.

3. Copy the link from the App (no need to write it manually)

Writing links manually is prone to errors. NeoServer provides a one-click copy feature in three places. After copying, you can paste it anywhere.

1. Copy the link for "This Server"

Server tab · Server List → Swipe left on a server → Copy Scheme Link

The copied link looks like:

neoserver://terminal?host=...&port=...&user=...

2. Copy in terminal quick mode

Terminal tab · Server List (quick mode) → Long press a server → Copy Scheme Link

3. Copy the link for "This Session" ⭐ Most useful

Terminal tab · Session List → Long press a session → Copy Scheme Link

This link bundles the "Y session connected to X server" all together:

• If this is a tmux session → automatically includes &tmuxName=...
• If this is a zellij session → automatically includes &zellijName=...
• Normal session → only includes host/port/user

A Link Copied prompt will pop up upon successful copy, and the link is now in your clipboard.

💡 Long press and copy a running tmux session to send to a colleague. When they open it via NeoServer, they will directly attach to the same session—both of you will enter the exact same terminal screen.

4. How to open this link

neoserver:// is an iOS link protocol. Anywhere you can click a link, it can wake up NeoServer:

• Safari: Paste it into the address bar and hit enter, or save it to your bookmarks and click it.
• Notes / Reminders: Save an entry, click it for direct access.
• Shortcuts: Fill the link in the "Open URL" action → can be bound to Siri voice, desktop icons, or automations.
• AirDrop: Send a link between two iPhones; the recipient clicks to connect instantly.
• Mail: Send the link as text; the recipient copies it into Safari to open.

📱 The first time you click a neoserver:// link on a physical device, iOS will prompt "Open in NeoServer?", just confirm it, and it won't ask again.

5. Three practical scenarios

🏠 Scenario 1: Turning "connect to production tmux" into a desktop icon

You need to connect to the main tmux session on the production machine every day. Instead of opening the App → finding the server → connecting → attaching every time, just turn it into an icon:

1. Copy this server's link in the App, then manually append &tmuxName=main;
2. Open iOS "Shortcuts" → New Shortcut → add a "URL" action, and paste this link;
3. Add an "Open URL" action;
4. Click Share → Add to Home Screen, name it "Connect to Prod", and choose an icon.

From now on, clicking this icon on your desktop will have NeoServer automatically connect and enter the main session, completely hands-free.

🎙️ Scenario 2: Connecting via voice

Connect the above Shortcut to Siri, and set a phrase like "Hey Siri, connect to prod". Once spoken, your phone will connect automatically.

🤝 Scenario 3: Throwing a session to a colleague

1. Terminal · Session List → Long press this session → Copy Scheme Link;
2. Send it to a colleague (AirDrop / WeChat both work);
3. They open it via NeoServer → automatically attach to the same tmux session.

(Prerequisite: The NeoServer server library on their iPhone must also be able to connect to the same host.)

6. Terminal link FAQs

Q: I clicked the link, but it connected to the wrong server? A: NeoServer finds the server based on host (+ port if provided + user if provided). If your library has two servers with the exact same host, it will connect to the first match. Filling in the port or user allows for precise differentiation.

Q: What happens if I click a link for a server not in my library? A: It will jump to the "New Server" page, with host/port/user already filled in for you. You just add the password or private key → Save → Automatically connects, and any session / directory included in the original link will still take effect.

Q: Can the link include the password directly so I don't have to enter it every time? A: No. This is a security restriction—links never carry passwords. Even if you manually add password=xxx, it will be ignored. Passwords only go through the App's internal Keychain.

Q: Can directories with Chinese characters or spaces be used in workdir? A: Yes. Just write it directly, for example, workdir=/home/me/my logs. The App will automatically handle special characters. The most reliable method is to copy it using the App rather than writing it manually.

Q: No response after clicking? A: ① Make sure it starts with neoserver://; ② The first time, it will prompt for confirmation to "Open in NeoServer"; ③ Check that host isn't left empty; ④ It doesn't matter if the App isn't in the foreground, it will wake up automatically.

Q: Can it be opened on Android / Windows? A: No. neoserver:// is only recognized by iPhones / iPads with NeoServer installed.

7. Appendix: Opening the Notification Center

Besides terminals, there's another link to open the Notification Center:

neoserver://notifications

Clicking the desktop notification widget uses exactly this.