# filefling

filefling is a macOS menubar utility for sending screenshots and files from a local Mac to a remote AI coding machine over SSH/SFTP, then copying a rendered clipboard output for use in shells, tmux sessions, editors, chats, and CLI AI-agent workflows.

## Canonical pages

- [Home](https://filefling.app/)
- [Human-readable docs](https://filefling.app/docs)
- [Guide: send macOS screenshots to AI coding agents](https://filefling.app/guides/send-macos-screenshots-to-ai-coding-agents)
- [Agent-readable Markdown docs](https://filefling.app/docs.md)
- [Download macOS beta ZIP](https://filefling.netlify.app/downloads/FileFling-1.0.0-beta-arm64.zip)

## What filefling does

- Current public build is a beta unsigned Apple silicon ZIP.
- Uploads the latest screenshot or a dragged file to a configured SSH destination for remote AI coding agents and developer workflows.
- Uses SFTP through the Node `ssh2` library.
- Copies rendered clipboard output after upload.
- Supports multiple destination profiles.
- Can import concrete hosts from `~/.ssh/config`.
- Shows latest screenshot preview before sending.
- Stores recent send history with actions such as copy, copy raw, retry, send again, reveal, delete, and search.
- Uses trust-on-first-use host-key verification with stored SHA256 fingerprints.

## Important docs sections

See [the complete Markdown documentation](https://filefling.app/docs.md), including:

- Getting started
- Recommended settings
- Destination profiles
- Clipboard templates
- Ways to send
- SSH config support
- Host-key trust
- Troubleshooting
- Security notes

## Notable constraints

- Advanced OpenSSH options such as `ProxyJump`, `ProxyCommand`, `Match`, and agent forwarding are not applied yet.
- Wildcard SSH config host patterns such as `Host *.internal` are not shown in the destination picker.
- Retry/reveal history actions require local file metadata and may not be available for older history entries.