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.
- 1Download the .dmg file from the website or releases page.
- 2Open the .dmg and drag Pluto Door into your Applications folder.
- 3Launch Pluto Door from your Applications folder or Spotlight.
- 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.
On first launch, macOS will ask for permission to access your Keychain. This is normal — Pluto Door uses macOS Keychain to securely encrypt your license key, SSH passwords, and API keys. Click "Always Allow" so you won't be asked again.
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.
- 1Copy your license key from the purchase confirmation or email.
- 2Open Pluto Door — you'll see the activation screen on first launch.
- 3Paste your license key and click Activate.
- 4The app validates your key online once, then works fully offline.
Your license key is permanently tied to 1 machine. It cannot be transferred to another device.
First Connection
Once activated, you're ready to connect to your first server. Pluto Door supports password and SSH key authentication.
- 1Click the + button or press ⌘N to create a new connection.
- 2Enter your server's hostname, port (default 22), and username.
- 3Choose your authentication method — password or SSH key.
- 4Optionally give the connection a name for easy identification.
- 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.
- Configurable scrollback buffer (up to 50,000 lines) with fast search (⌘F).
- Integrated file browser and terminal in a split-pane layout.
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.
- List view for navigating the remote filesystem.
- Upload and download files with a single click.
- Rename, delete, and create directories inline.
- Open text files directly in the built-in code editor.
- Synced navigation — changing directories in the terminal updates the file browser and vice versa.
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 popular languages (JavaScript, TypeScript, Python, Rust, HTML, CSS, JSON, YAML, Markdown, XML).
- Font ligature support (Fira Code, JetBrains Mono, etc.).
- Configurable font size, line height, and word wrap.
- Save with ⌘S — changes are written back to the server over SFTP.
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 lines, bell behavior.
- Editor: font size, font family, ligatures, line height, word wrap.
- General: default SSH port, auto-reconnect, confirm on disconnect.
- AI: OpenAI API key (stored securely in macOS Keychain).
- Data & Privacy: clear chat history, command history, connection statuses, or reset all settings.
- All settings are stored locally. Connection credentials and your OpenAI API key are encrypted in macOS Keychain.
Security & Privacy
Pluto Door is built with a local-first, zero-trust architecture. Your sensitive data never leaves your machine.
- SSH passwords, license keys, and your OpenAI API key are encrypted in macOS Keychain — the same system-level vault used by Safari, Mail, and other Apple apps.
- Connection details (hostname, port, username) are stored locally in a JSON file on disk. No passwords are ever written to disk unencrypted.
- The AI assistant calls OpenAI directly using your API key. Your prompts and responses never pass through our servers.
- The only network call Pluto Door makes is a one-time license verification on activation. After that, the app works fully offline.
- No analytics, no telemetry, no crash reporting. We literally cannot see what you do in the app.
On first launch, macOS will show a Keychain access prompt. This is macOS verifying that Pluto Door is allowed to store and retrieve your encrypted credentials. Click "Always Allow" to grant permanent access — you won't be asked again.
Connection History
Pluto Door keeps a history of your connections so you can quickly reconnect to servers you've used before.
- Saved connections shown on the home screen for one-click access.
- Provider auto-detection with badges (AWS, GCP, Azure, DigitalOcean, Hetzner, etc.).
- Status indicators showing last connection result (success/error).
- Label connections with a custom name for easy identification.
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 |
⌘+/ | 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.