Pluto Door Docs

Pluto Door is a Mac app. One download works on both Apple Silicon and Intel Macs.

1. 1Download the .dmg from plutodoor.com.
2. 2Open the .dmg and drag Pluto Door into your Applications folder.
3. 3Open Pluto Door from Applications or Spotlight.

You sign in with Apple or Google. Pluto Door opens your browser for this, so you never type a password into the app.

1. 1Open Pluto Door and click Continue with Apple or Continue with Google.
2. 2Your browser opens. Finish signing in there.
3. 3The browser sends you back to Pluto Door, and the app unlocks.

New accounts get a 14-day free trial. No card needed.

When the trial ends, the app shows "Your trial has ended". Click Choose a plan to pick monthly, yearly or lifetime on plutodoor.com/account. The app unlocks by itself once the plan is active.

If you bought Pluto Door before subscriptions existed, you're an early supporter. You get everything for free.

• Easiest: sign in with Apple or Google using the email you bought with. The app unlocks.
• Or use your old license key. On the sign-in screen, click "Have a lifetime license key?", paste the key (it starts with PLUTO-) and click Activate.

Add a server to start. Pluto Door connects over SSH with a password or an SSH key.

1. 1On the Servers page, add a new server, or press Cmd+N.
2. 2Enter the host, port (22 by default) and username.
3. 3Choose password or SSH key. For a key, set the key path (for example ~/.ssh/id_rsa) and a passphrase if it has one.
4. 4Give it a name you'll recognise and save.
5. 5Open the server to connect.

• Already have hosts in ~/.ssh/config? Use Import SSH config on the home screen.
• You can require Touch ID before a server opens.
• You can add local port forwards, like ssh -L.

Each server can open in three views. The first time, Pluto Door asks which one you want as the default. You can switch any time.

• Agent (Cmd+1): describe what you need and Ori does the work, asking before it changes anything.
• Desktop (Cmd+2): the server opens as Pluto XOS, a desktop with windows, a dock and apps.
• Classic (Cmd+3): a terminal on top and a file browser below.

Your servers are listed on the home screen so you can open them again in one click.

• Search by name, host, user or cloud provider.
• Provider badges are detected for you (AWS, Google Cloud, Azure, DigitalOcean, Hetzner and more), or set one yourself.
• Test, edit or delete a server from its row.
• Save the servers you have open as a workspace, then open them all together later.

Ori is the AI agent in Pluto Door. You describe a task in plain words, and Ori works on it: it reads files and logs, runs commands, edits config and reports back.

• Ori works inside a server over SSH, or in an AWS, Google Cloud or Azure account through its API.
• Open the Agent view on a server, or go to Agents on the home screen and pick a target under "Where should Ori work?".
• Pick Several servers to run the same task on each one.
• Press Cmd+Return to send the task.
• Stop a running task with the Stop button, or press Cmd+. anywhere.

Ori runs on your own AI key. It talks to the provider directly, and the provider bills you for usage.

1. 1Open Settings (Cmd+,) and go to AI Provider.
2. 2Paste your Anthropic (Claude) API key or your OpenAI API key.
3. 3Leave Agent Provider on Auto. It uses the first provider that's set up, Claude first.
4. 4Click Save Changes.

With Claude, Model Choice sets the cost and quality balance. Auto sizes each task: quick checks use a faster, cheaper model and bigger work uses the most capable one. You can also pick Best quality or Lowest cost.

Reading is automatic. Anything that changes a server waits for you.

When Ori wants to make a change, it shows you the command or file edit and why. You can approve it, edit the command first, approve with a note for Ori, or reject it with a reason.

Pick a mode before you start a task:

• Ask before changes (default): reads run right away; every change waits for your approval.
• Ask before every step: every action waits for your approval, reads included.
• Run without asking: Ori works on its own.

For bigger jobs, Ori first writes a plan: a short summary and the steps it will take. You read it and click Approve plan once.

• After you approve, the changes in the plan run without asking each time.
• Deletions still ask again, even inside an approved plan.
• Commands that could cut off access always ask.

Every file Ori edits is shown as a diff, with removed lines in red and added lines in green. The Changes tab in the side panel lists everything Ori changed in a task.

• Before Ori edits a file, it keeps a copy of the original on your Mac.
• When the task has stopped, click Undo changes to put the files back. Files Ori created are removed.
• If a file is too large to copy, the change still goes ahead but can't be undone.

Ori keeps short notes about each server and cloud account, so it doesn't rediscover the same things every time.

• Open the Memory tab in the side panel to read the notes.
• You can edit or clear them.
• Secrets are masked before a note is saved.
• Notes stay on your Mac.

Skills are playbooks Ori opens when a task calls for them, like a runbook for hardening SSH. Find them under Skills on the home screen.

• Turn a skill off and Ori won't see it.
• After a task finishes, you can save it as a skill and reuse it later.
• Skills are instructions only. Nothing in them runs on your Mac, and Ori's commands still go through the normal approvals.

Ori can check a server or cloud account on a schedule and tell you how it went. Set them up in the Schedules or Calendar app on the Pluto XOS desktop.

• Start from a preset, like disk space, failed services, backups, pending security updates or TLS certificates expiring soon. Or write your own.
• Run every day, on weekdays, weekly, or every few hours.
• Checks only report. They never change anything. If Ori wants to change something, it waits for you.
• Results show as macOS notifications. Checks that need attention always notify you; turn on Notify for Passing Checks in Settings > General to hear about the rest.

Pluto XOS turns each server into a desktop. Apps open in windows you can move, resize and minimise, with a dock at the bottom.

• The desktop shows the server, its home folder and its disks as icons.
• Right-click the desktop to open a terminal, open Home, change the wallpaper or switch views.
• The notifications panel warns you about low disk space, low memory, failed services and Ori's checks.
• Change the wallpaper, dock and sound in Desktop Settings.

• Ori: hand the AI agent a task.
• Terminal: a shell on the server.
• Files: browse and edit files over SFTP. Deleted files go to the Trash.
• Code: edit files and whole projects on the server.
• Activity: processes and live CPU and memory use.
• Logs: the system journal and log files, live.
• Services: start, stop and inspect systemd services.
• Hangar: install and update software.
• Network: interfaces, open ports, firewall and tools.
• Disk Usage: see what fills the disk and clean up.
• Users & Keys: accounts, sessions and SSH keys.
• This Pod: system, hardware, network and disks.
• Calendar: the server clock, timers and cron jobs, plus Ori's checks.
• Schedules: Ori's scheduled checks, history and notifications.
• Trash: restore or permanently delete files.

Hangar is the app store for your server. It installs, updates and removes software using the server's own package manager.

• Works with apt, dnf, yum, zypper, pacman and apk.
• Browse a curated catalog of common server software, or search the package repositories.
• Package names are matched to your distro for you.
• Changes need passwordless sudo. Without it, Hangar shows you the exact command to run instead.

Press Cmd+K on the desktop to open Spotlight.

• Search for apps and actions, like a new terminal window or changing the wallpaper.
• Type a path like /etc/nginx to open it in Files, or a file path to edit it in Code.
• Switch to the Agent or Classic view.

Classic view puts a terminal on top and a file browser below.

• Full color support, built on xterm.js.
• Search the terminal with Cmd+F.
• Scrollback of 100 to 50,000 lines.
• Open your command history with Cmd+Shift+H.
• Set font size, cursor style, scrollback and the bell in Settings > Terminal.

The file browser works over SFTP. Manage files without typing commands.

• Upload, download, preview, rename and delete files.
• Create folders.
• Open text files in the built-in editor.
• Stays in sync with the terminal: cd in the terminal and the browser follows, and the other way round.

Edit server files right in Pluto Door. No download and re-upload.

• Syntax highlighting for JavaScript, TypeScript, Python, Rust, HTML, CSS, JSON, YAML, Markdown and XML.
• Font ligatures, font size, line height and word wrap in Settings > Editor.
• Save with Cmd+S. The file is written back over SFTP.

Classic view has a chat panel for quick questions and command suggestions. It uses your OpenAI API key.

• Toggle it with Cmd+I.
• It can see your recent terminal output and current folder.
• Select an error in the terminal and press Cmd+E to ask for an explanation and a fix.
• Run a suggested command, or insert it into the terminal to edit first.

Open Settings with Cmd+,.

• AI Provider: your API keys, the agent provider and model choice.
• Terminal: font size, cursor style, scrollback lines, bell.
• Editor: font size, font family, ligatures, line height, word wrap.
• General: default SSH port, auto reconnect, confirm on disconnect, menu bar, start at login, check notifications, and Check for Updates.
• Data & Privacy: clear chat history, command history or connection statuses, or reset everything.

A server shows Ori what's inside one machine. A cloud account shows Ori what's around your servers: every machine, firewall, disk, backup and the bill.

• Add accounts from Cloud accounts on the home screen.
• Pluto Door supports AWS, Google Cloud and Azure.
• Ori can review costs, find unused resources, check what's open to the internet and more.
• Scheduled checks work on cloud accounts too.
• Changes and reads of secrets wait for your approval, like on a server.

• AWS: use a profile from your AWS CLI setup (~/.aws), or an access key. Set a region, and optionally a role to assume. The ReadOnlyAccess and AWSBillingReadOnlyAccess policies are enough for reviews.
• Google Cloud: use an account you signed in to with gcloud auth login, or a service-account JSON key. Enter the project ID. The Viewer and Recommender Viewer roles are enough for reviews.
• Azure: use your Azure CLI sign-in (run az login in Terminal first), or a service principal with tenant ID, client ID and client secret. Pick the subscription. The Reader and Cost Management Reader roles are enough for reviews.

• Free for 14 days. No card needed.
• Monthly: $4.99 a month.
• Yearly: $49.99 a year.
• Lifetime: $59, paid once.

Every plan includes everything in the app. Ori's AI usage is billed by your AI provider, on your own key.

Manage your plan on plutodoor.com/account. In the app, open Account and click Manage subscription to go there.

• Switch between monthly and yearly. The change starts at your next renewal.
• Upgrade to lifetime.
• Cancel any time.

Your account can be signed in on one Mac at a time. Signing in on a new Mac signs out the old one.

Your servers, cloud accounts and keys don't move with your account. They stay on the Mac where you added them.

Your connections, cloud accounts, keys and Ori's history are stored only on your Mac. They are never synced.

• Passwords, API keys and cloud secrets are kept in the macOS Keychain.
• Everything else lives in ~/Library/Application Support/com.bytelights.plutodoor/.
• Ori's undo copies and memory notes are kept there too.

• Pluto Door only contacts plutodoor.com for sign-in, plan, license and trial checks, and update checks.
• Ori talks directly to your AI provider with your key. Your tasks never pass through our servers.
• Secrets in command output and files (like keys in a .env file) are masked before they reach the AI model.
• Cloud accounts talk directly to AWS, Google Cloud or Azure.
• No analytics in the app.

Pluto Door checks for updates a few seconds after it opens. When a new version is out, a card shows in the corner.

• Click Install and restart to update now, or Later to skip for this time.
• Nothing downloads until you click Install.
• To check by hand, go to Settings > General > Check for Updates.
• Your servers, settings and keys are kept.