Copy an image
Use a screenshot, clipboard bitmap, or image file copied from Finder. Image2TTY detects the image and re-encodes it cleanly for agent-readable workflows.
Native macOS utility for AI coding agents
Image2TTY
Turn screenshots into clean file paths for AI coding agents, terminals, editors, and SSH sessions instead of bulky image blobs.
7-day trial. The Pro unlock is handled inside the app through the App Store.
AI-agent ready
Screenshot paths work cleanly in Codex, Claude Code, and terminal agents
SSH profiles
Password, key file, ssh-agent, or config
No backend
Local utility, your configured destinations only
AI agent path
Copy screenshot file paths for coding agents that can read local or remote files.
Local path
Save a clipboard image and copy a shell-safe file path.
Remote SSH path
Upload by SSH and copy the server path.
Built for AI coding work
The fastest way to show an AI agent what you are seeing
When you are working with Codex, Claude Code, terminal agents, or remote developer tools, screenshots often need to become files before the agent can inspect them. Image2TTY turns the current clipboard image into a path the agent can open, read, analyze, and reference in the same conversation.
1
Capture
Take a screenshot of a UI bug, chart, terminal error, design reference, or browser state.
2
Copy Path
Image2TTY saves or uploads the image and copies a path instead of putting raw image data into your prompt.
3
Ask the Agent
Your AI agent receives a stable local path, remote path, or shell-created file it can inspect.
Codex example
Instead of describing the screenshot, paste the copied path
A screenshot copied from macOS becomes a normal file. Your prompt can point Codex directly at it, which keeps the conversation text-based and easy to repeat.
Why it exists
Screenshots are useful. AI agents and terminals want paths.
Modern coding workflows often happen inside terminal agents, SSH sessions, browser consoles, and AI coding assistants. Those surfaces usually handle file paths better than rich clipboard image data. Image2TTY bridges that gap without running a terminal emulator or sending your images to a hosted service.
Choose the destination
Save locally, upload to a remote profile, or generate a shell upload script for the current terminal session.
Copy terminal-ready text
Image2TTY copies a shell-safe path or script to the clipboard so you can paste it into the focused app with Cmd+V.
Workflow modes
Three practical ways to get an image into a text-only workflow
$ open /Users/me/Image2TTY/image.png
Local Path
Save the image on this Mac and copy a shell-escaped local path. This is ideal for local terminals, editors, scripts, and tools that can read files from your machine.
- User-chosen folder through the macOS folder picker
- Optional custom folder with security-scoped access
- PNG or JPEG output with predictable filenames
$ ssh server 'cat > /tmp/image2tty/image.png'
Remote Profile
Upload the generated image through Image2TTY's SSH connection and copy the remote path that your server-side shell or coding agent can access.
- Username and password profiles
- SSH key file and ssh-agent support
- Host key handling through OpenSSH known hosts
$ mkdir -p /tmp/image2tty && base64 -d ...
Shell Upload
Copy a POSIX-style script and paste it into the current shell prompt. The script creates the target directory, decodes the embedded image, writes the file, and prints the final path.
- Works inside an existing SSH session
- No separate server credentials required
- Large scripts warn before copying
Remote uploads
Designed for real SSH servers, not demos
Remote Profile mode is built around the system OpenSSH tools that developers already trust. Configure a host, username, destination directory, and authentication method. Image2TTY handles the upload and returns the exact server path you can paste into your remote shell or AI agent.
Password authentication is supported and stored in macOS Keychain. SSH keys, ssh-agent, and OpenSSH config usage are supported for teams that already manage SSH access centrally.
Authentication
Password, SSH key file, ssh-agent, or OpenSSH config.
Directories
Remote folders can be created by the upload flow when needed.
Safety prompt
First remote upload asks for confirmation before sending clipboard images to that host.
History
Recent generated paths can be copied again without re-uploading.
Privacy and security
No cloud backend. Your destinations only.
Image2TTY is built as a local macOS utility. It does not operate a hosted upload service, does not collect analytics, and does not sell personal data.
Clipboard stays local
Clipboard images are read on your Mac. They are only saved locally or uploaded to destinations you configure.
Keychain for passwords
Remote profile passwords are stored in macOS Keychain. Image2TTY does not store payment card data.
Clipboard-first workflow
Image2TTY copies generated text to the clipboard and shows a clear prompt when it is ready for you to press Cmd+V.
StoreKit purchases
The Pro unlock is processed by Apple through the App Store. Restore Purchase is available from the app.
Trial
Try it for 7 days. Unlock once.
Image2TTY is a focused utility for people who repeatedly move images into text-first development workflows. The trial gives you time to test local, remote, and shell upload modes with your real tools.
One-time App Store unlock after the 7-day trial.
- Unlimited copy workflows
- Remote SSH profiles
- Shell upload mode
- History, hotkey, and menu bar access
FAQ
Details before you install
Is Image2TTY a terminal emulator?
No. Image2TTY does not emulate a terminal and does not read your terminal contents. It prepares text and copies that text to the clipboard.
Can it upload directly to a server?
Yes. Remote Profile mode uses SSH with your configured host, username, directory, and authentication method. Password profiles store passwords in Keychain.
When should I use Shell Upload?
Use Shell Upload when you are already inside the target shell or SSH session and want the image file created there without opening a second connection from the app.
How do I paste the generated path?
Image2TTY copies the generated path or script to the clipboard. When the on-screen message says it is ready, press Cmd+V in your terminal, editor, or AI coding tool.
What image formats are supported?
Image2TTY can read common clipboard image data and Finder image file URLs, then write clean PNG or JPEG output.
Does it have a subscription?
No. Image2TTY uses a 7-day trial followed by a one-time non-consumable App Store purchase.