ShellSage
ShellSage AI server agent assisting mobile SSH workflow
AI WORKFLOWS

Ask Sage: Your Built-In AI Assistant for SSH on Mobile

Explore how ShellSage's AI assistant, Sage, simplifies SSH tasks with voice input, smart suggestions, and more.


ShellSage's Sage AI assistant lets you ask for help, explain terminal output, and suggest or fix commands directly within your mobile SSH client.

What is Sage and How Does It Work?

Sage is the AI assistant integrated into the ShellSage app, designed to help you navigate SSH tasks from your mobile device. It leverages AI models like OpenAI and Claude, and with the Bring Your Own Key (BYOK) feature, you can use your own API key for these services. Sage is adept at reading your terminal's current output, allowing it to provide context-aware assistance.

When you open "Ask Sage AI for Help," you're entering a chat-like interface where you can ask questions in plain English. Whether you need a command, an explanation, or a fix, Sage determines the best response. This makes it invaluable for both beginners and seasoned sysadmins who want to streamline their workflow.

A punchy, self-contained key line from your own explanation.

One of the standout features of Sage is its ability to interpret what's on your screen. You can attach a screenshot or use voice input to dictate your query. This is particularly useful when you're on the go and need to multitask efficiently.

How to Use Sage for Command Suggestions

Integrating AI into your SSH workflow can significantly enhance productivity. With Sage, you can get command suggestions directly in your terminal. For instance, if you're unsure about the syntax for a command, you can ask Sage, "How do I list all files in a directory?" Sage will provide the command ls -l or suggest alternatives based on the context.

To use this feature, simply open Sage, type your question, and review the suggested command. You can tap to insert it at your prompt or run it directly. The destructive-command shield ensures you have a preview of the command's impact, protecting your system from unintended changes.

Sage's suggestions make it easy to run commands correctly, even on the go.

Most mobile SSH clients like Termius or JuiceSSH require you to manually input commands or reference external documentation. ShellSage's AI integration provides a more seamless experience by offering context-aware suggestions and explanations.

When Should You Use the Explain Feature?

Understanding complex terminal outputs can be a challenge, especially on a mobile device. Sage's "Explain" feature is perfect for these situations. If you come across a confusing line of output, long-press it, and select "Explain." Sage will break down the output, helping you understand what it means.

This feature is particularly handy for those moments when you're troubleshooting an issue and need clarity on what the system is reporting. For example, if you see an unfamiliar error message, Sage can provide a detailed explanation, potentially suggesting fixes as well.

While other SSH clients like Blink Shell may offer some level of output interpretation, they often lack the AI-driven insights that Sage provides. This makes ShellSage a powerful tool for sysadmins who need to diagnose problems quickly.

How to Fix Commands with Sage

We all make mistakes, and command-line errors are no exception. With Sage, fixing these errors becomes less of a hassle. If you enter a command incorrectly, you can long-press the line and choose "Fix." Sage will analyze the command, identify the mistake, and suggest a corrected version.

For example, if you accidentally type ps aux| grep httpd when you meant to check for Nginx processes, Sage might suggest replacing "httpd" with "nginx." This feature saves time and reduces frustration, especially when you're working under pressure.

In contrast, typical SSH clients require you to debug commands manually, often involving tedious web searches or trial and error. Sage's ability to fix commands on the fly sets ShellSage apart as a truly intelligent SSH client.

Why Choose ShellSage Over Other SSH Clients?

While many SSH clients like Termius and JuiceSSH offer basic connectivity and command execution, they often lack the advanced features that ShellSage provides. For instance, the blast-radius preview ensures you understand the potential impact of a command before you execute it, a feature not commonly found in other clients.

Additionally, the integration of voice input allows you to dictate commands and queries to Sage, making it easier to manage tasks when typing isn't convenient. This is particularly useful for sysadmins who need to operate hands-free or when using a small mobile screen.

ShellSage's real SFTP capabilities also enhance its utility, allowing for seamless file transfers alongside SSH operations. This combination of features makes ShellSage a comprehensive tool for mobile SSH management.

⚡ Key takeaways

Sam Okonkwo
Your Questions, Answered

Frequently Asked Questions

To transfer files over SSH, you can use the Secure Copy Protocol (SCP) or SFTP (SSH File Transfer Protocol). These protocols allow you to securely copy files between a local and a remote host. ShellSage provides real SFTP capabilities directly from your mobile device, making file transfers seamless and secure.
Yes, you can use an SSH terminal on a phone. There are several apps available that allow you to access SSH terminals from your mobile device. ShellSage is one such app that not only provides SSH access but also includes features like an AI assistant and voice input to enhance your mobile SSH experience.
An AI assistant in an SSH app can help users by providing command suggestions, explaining terminal output, and troubleshooting errors. In ShellSage, the AI assistant named Sage offers these functionalities, making it easier to manage SSH tasks on a mobile device.
ShellSage keeps the key in encrypted secure storage on the device, with an optional biometric gate before any host will connect, and host-key pinning to catch an impostor server. Saving a host also syncs it: the key or password is uploaded and stored encrypted at rest (AES-256) on ShellSage's servers so your hosts follow you between devices. Be clear-eyed about the trade , that is encryption at rest, not zero-knowledge, so the server can decrypt the credential to return it at connect time. Delete the host, or the account, and the stored secret is destroyed with it.
Yes, ShellSage can run AI commands through its integrated AI assistant, Sage. You can ask Sage for help with commands, explanations, or troubleshooting, and it will provide context-aware responses based on your terminal's current state.
ShellSage offers a free version with essential features. However, some advanced functionalities, such as the AI assistant Sage and enhanced security features, may require a subscription or one-time purchase.
ShellSage requires an internet connection for features that involve the AI assistant Sage and SFTP transfers. However, basic SSH terminal access can be used offline once you are connected to a local network.
Download ShellSage free
ShellSage is an AI-first SSH terminal with Sage built in: it explains output, fixes broken commands, and previews the blast radius before anything runs. Start on the free Hobby plan with no credit card, and get a 7-day full-Pro trial when you want everything.
← More tutorials