Documentation

Pluto Door Docs

Everything you need to know about installing, using, and getting the most out of Pluto Door.

Getting Started

Installation

Pluto Door is available for macOS, with Windows and Linux support coming soon. Download the latest .dmg from our website or the releases page.

  1. 1Download the .dmg file from the website or releases page.
  2. 2Open the .dmg and drag Pluto Door into your Applications folder.
  3. 3Launch Pluto Door from your Applications folder or Spotlight.
  4. 4macOS may ask you to allow the app in System Preferences → Privacy & Security.

Pluto Door requires macOS 12 (Monterey) or later. Apple Silicon and Intel Macs are both supported.

License Activation

After purchasing, you'll receive a license key via email and on the confirmation screen. You need to activate your license to use Pluto Door.

  1. 1Copy your license key from the purchase confirmation or email.
  2. 2Open Pluto Door — you'll see the activation screen on first launch.
  3. 3Paste your license key and click Activate.
  4. 4The app validates your key online once, then works fully offline.

Your license key is tied to 1 machine. If you need to transfer your license to a different machine, contact support.

First Connection

Once activated, you're ready to connect to your first server. Pluto Door supports password and SSH key authentication.

  1. 1Click the + button or press ⌘N to create a new connection.
  2. 2Enter your server's hostname, port (default 22), and username.
  3. 3Choose your authentication method — password or SSH key.
  4. 4Optionally give the connection a label and color for easy identification.
  5. 5Click Connect. Pluto Door will establish the SSH session.

Pluto Door automatically detects SSH keys in ~/.ssh. You can also browse to select a key file from any location.

Features

SSH Terminal

The terminal is the heart of Pluto Door. Built on xterm.js with GPU-accelerated rendering, it delivers a fast and responsive experience.

  • Full xterm.js terminal with 256-color and true-color support.
  • GPU-accelerated rendering via WebGL for smooth scrolling and output.
  • Customizable font family, size, line height, and cursor style.
  • Unlimited scrollback buffer with fast search (⌘F).
  • Split panes — run multiple sessions side by side.
  • Tab support for managing multiple connections.

AI Assistant

The built-in AI assistant helps you work faster by understanding your terminal context and suggesting commands. It uses your own OpenAI API key — we never see your prompts.

  • Ask questions about Linux commands, server administration, and DevOps.
  • The AI can see your recent terminal output for context-aware suggestions.
  • Generate complex commands like awk, sed, and find with natural language.
  • Explain error messages and suggest fixes.
  • Toggle the AI panel with ⌘I or from the sidebar.

The AI assistant requires an OpenAI API key. Add your key in Settings → AI. API usage costs are billed directly by OpenAI.

File Browser

The SFTP-powered file browser lets you manage remote files visually. Upload, download, rename, and delete files without typing a single command.

  • Tree-view and grid-view for navigating the remote filesystem.
  • Drag-and-drop upload from your local machine.
  • Download files and folders with a single click.
  • Rename, delete, and move files with right-click context menus.
  • File previews for images, text files, and common formats.
  • Breadcrumb navigation with quick path editing.

Code Editor

Edit remote files directly in Pluto Door's built-in code editor. No need to download, edit locally, and re-upload.

  • Syntax highlighting for 100+ languages.
  • Font ligature support (Fira Code, JetBrains Mono, etc.).
  • Configurable tab size, word wrap, and minimap.
  • Find and replace with regex support.
  • Multiple cursors and selection editing.
  • Auto-save with conflict detection.

Settings

Pluto Door is highly customizable. Tweak every aspect of the terminal, editor, and app behavior to match your workflow.

  • Terminal: font, size, cursor style, scrollback, bell behavior.
  • Editor: tab size, word wrap, minimap, ligatures, auto-save.
  • Appearance: accent color, sidebar position, compact mode.
  • AI: API key, model selection, context window size.
  • Connections: default port, authentication preferences, keepalive interval.
  • All settings are stored locally in a JSON config file.

Connection History

Pluto Door keeps a history of your connections so you can quickly reconnect to servers you've used before.

  • Recent connections shown on the home screen for one-click access.
  • Search and filter your connection history.
  • Pin frequently used connections to the top.
  • Color-code and label connections for easy identification.
  • Import and export connections as JSON for backup or sharing.

Keyboard Shortcuts

Shortcuts Reference

Pluto Door is designed to be keyboard-driven. Here are all the shortcuts organized by context.

General

+N
New connection
+,
Open settings
+Q
Quit Pluto Door

Terminal

+F
Search in terminal
+I
Toggle AI assistant
+C
Copy (when text selected)
+V
Paste
+
Scroll to top
+
Scroll to bottom

Editor

+S
Save file
+Z
Undo
++Z
Redo
+F
Find
+H
Find and replace
+G
Go to line
+D
Select next occurrence
+
Move line up
+
Move line down
+/
Toggle comment

Troubleshooting

Connection Issues

Having trouble connecting? Here are solutions to the most common connection problems.

App Issues

Problems with the app itself? These solutions cover the most common issues.

FAQ

Common Questions