ShellSage
ShellSage mobile terminal uploading files into Sage AI reference context
AI WORKFLOWS

How to Upload Files for AI Reference in ShellSage

Learn how to upload and use files as reference for AI in ShellSage.


To upload reference images and files for your AI to read on ShellSage, use the phone's system picker to select a PDF, Excel, Zip, or image file directly from your device.

Why Upload Reference Files to ShellSage?

When working with complex systems over SSH, having the right documentation at your fingertips is invaluable. Whether it’s a configuration file, a spec sheet, or a screenshot of an error, these resources can significantly speed up troubleshooting and development tasks. ShellSage allows you to upload these files so that its AI, Sage, can read and interpret them, providing insights and guidance based on the content.

This feature is particularly useful when you’re on the move. Instead of switching between multiple devices or applications, you can consolidate your workflow within ShellSage. By uploading files directly from your phone, you streamline the process, making it easier to manage and access critical information.

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

Imagine being able to upload a PDF containing API documentation or a configuration file directly into your terminal session. Sage can then parse this information and assist you with command suggestions or explanations, reducing the need to manually sift through documents.

How to Upload Files in ShellSage

Uploading files in ShellSage is straightforward and integrated with your phone’s capabilities. Here’s a step-by-step guide to get you started:

  1. Open the ShellSage app on your phone.
  2. Navigate to the file upload section, typically accessible from the main interface.
  3. Use the phone's system picker to select the file type you wish to upload. ShellSage supports PDFs, Excel files, Zip files, and images.
  4. Once selected, the file will be uploaded and available for Sage to read and interpret.

By using the system picker, ShellSage leverages the native file management capabilities of your phone, ensuring a seamless experience. This integration means you don’t need to worry about compatibility issues or additional software installations.

With ShellSage, uploading files from your phone is as easy as selecting them from your gallery.

Once uploaded, Sage can access and utilize the information, allowing you to perform tasks like debugging code, configuring servers, and more, all with AI-driven assistance.

What Types of Files Can You Upload?

ShellSage supports several file types to maximize its utility. You can upload:

Each file type serves a specific purpose. For instance, uploading a PDF manual can help Sage provide detailed command explanations, while an Excel file might be used to automate configurations based on the data it contains.

By supporting these diverse file types, ShellSage ensures that you can leverage a wide range of resources, enhancing your productivity and efficiency.

How Does This Compare to Other Mobile SSH Clients?

Most mobile SSH clients like Termius and JuiceSSH offer basic connectivity features but lack the integration of AI-driven support for reading uploaded files. Typically, users would have to manually reference documentation from separate apps or devices, which can be cumbersome and time-consuming.

ShellSage distinguishes itself by incorporating AI directly into the workflow. With Sage, you not only get command suggestions and explanations but also the ability to upload files for contextual assistance. This feature is absent in many competitors, making ShellSage a more powerful tool for sysadmins and developers on the go.

In contrast, while Termius and Blink Shell offer robust SSH capabilities, they don’t provide the same level of AI integration, such as interpreting uploaded documents to assist with command execution or troubleshooting.

When Should You Use File Uploads in ShellSage?

File uploads in ShellSage are best used when you need quick access to reference materials without leaving your SSH session. This is particularly useful in scenarios such as:

These use cases highlight the flexibility and power of having AI-assisted file interpretation directly within your SSH client. It’s a game-changer for those who need to work efficiently while managing complex systems.

From my experience, having quick access to documentation without leaving the terminal has saved me countless hours during on-call shifts, especially when troubleshooting unfamiliar systems.

⚡ Key takeaways

Devon Hale
Your Questions, Answered

Frequently Asked Questions

To transfer files over SSH, you typically use tools like SCP (Secure Copy Protocol) or SFTP (SSH File Transfer Protocol). These allow you to securely copy files between your local machine and a remote server. ShellSage simplifies this process by providing real SFTP capabilities directly from your phone, making file transfers seamless and secure.
Yes, you can use an SSH terminal on a phone with various apps available for both iOS and Android. These apps allow you to connect to remote servers and execute commands just like you would on a desktop. ShellSage enhances this experience by integrating an AI assistant and voice input, providing a more intuitive and efficient way to manage SSH sessions on the go.
Uploading files for AI reference in ShellSage allows its AI, Sage, to read and interpret the content of documents like PDFs, Excel files, or images. This feature helps users access critical information and insights directly within the app, streamlining troubleshooting and development tasks.
ShellSage offers a range of features that may be available in both free and paid versions. To get detailed information about the pricing and available plans, it's best to visit the official ShellSage website or app store listing.
ShellSage requires an internet connection to perform most of its functions, especially those involving remote server access and AI interactions. However, some local functionalities may still be accessible offline. Always check the app's documentation for specific offline capabilities.
Two layers, and it is worth being exact about both. On your phone the private key is held in encrypted secure storage behind an optional biometric gate. On the server, every host you save has its key or password stored encrypted at rest (AES-256), which is how a new phone picks up your servers without re-entering anything. That means it is encryption at rest rather than end-to-end: the server can decrypt the secret and hands it back to the app when you connect. Your commands, terminal scrollback and voice audio are never stored on ShellSage's servers, and deleting a host removes its stored credential.
Yes, ShellSage features an AI assistant named Sage that can execute AI-driven commands. This allows users to interact with their SSH sessions more intuitively, using AI to assist with tasks such as troubleshooting, file interpretation, and system management.
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