# Snag

> Capture anything and send it everywhere. Ask your agents and run your workflows, hands-free in the car or on your iPhone on the train.

Every page below is markdown at its .md URL. The help and developer pages are built from the app's own docs.

## Snag

- [Snag: talk to your agents, hands-free, on iPhone](https://snag.fm/index.md): Capture anything and send it everywhere. Ask your agents and run your workflows, hands-free in the car or on your iPhone on the train.
- [Snag desktop: a timer in your bar, for Linux](https://snag.fm/desktop.md): Snag desktop for Linux: a timer in your bar, quick capture from a keybind, and a CLI for everything. Built for Omarchy and Hyprland first.
- [Integrations: where Snag sends your captures](https://snag.fm/integrations.md): Every place Snag can send a capture: your Snag account and eight apps and tools, how each connects, what it sees, and the options for builders.
- [Bring your own stack: Snag for builders](https://snag.fm/byo.md): Drive your own agents, n8n and Zapier workflows, Git-defined commands and models by voice. Approve from the car. Capture to your own backends is free.
- [Pricing: Snag Free and Snag Pro](https://snag.fm/pricing.md): Capture is free, in CarPlay too. Pro adds Snag Control for your agents and unlimited smart captures: £6.99 a month or £59.99 a year, with two weeks free.
- [Get Snag for iPhone: beta and App Store](https://snag.fm/download.md): Snag: Hands-Free Capture for iPhone, from the App Store or the TestFlight beta. What you need, and a QR code to open it on your phone.
- [Support: Snag](https://snag.fm/support.md): Help with Snag: how to get in touch, your captures, Snag Pro, CarPlay, and a destination that stopped working.

## How it works

- [How Snag for iPhone works](https://snag.fm/how-it-works/iphone.md): Snag for iPhone in five steps: set it up, capture by text or voice, choose where it goes, get actions back, and run your agents with Pro.
- [How Snag in CarPlay works](https://snag.fm/how-it-works/carplay.md): Snag on the car screen: capture with Snag this, ask an agent, approve what is waiting by voice or with your code word, and park the rest for the phone.
- [How Snag desktop works](https://snag.fm/how-it-works/desktop.md): Snag desktop in six steps: sign in, bind the keys, capture from a key, run the timer, answer for idle time and check it with snag doctor.

## Help for iPhone

- [Snag help](https://snag.fm/help.md): How to use Snag on iPhone, in CarPlay and on the desktop: things to try first, capture, destinations, Snag Control, commands, the desktop timer and fixes.
- [Getting started](https://snag.fm/help/getting-started.md): Snag (App Store name "Snag: Hands-Free Capture") catches what you type or say and sends it where you work: your Snag account, your notes.
- [Snag Capture](https://snag.fm/help/capture.md): Every capture is kept in your Snag account on the iPhone, and also goes to your default destination if you have connected one. Capture is free.
- [Your Snag account](https://snag.fm/help/snag-account.md): Your Snag account is where every capture is kept. It is the default destination.
- [Smart captures](https://snag.fm/help/smart-captures.md): A smart capture is a voice capture that Snag found at least one action in: something you said you need to do. Each action keeps the words it came from.
- [Destinations](https://snag.fm/help/destinations.md): A destination is a place Snag sends captures to. The app calls them connections: Settings > Connections lists what is connected.
- [Obsidian](https://snag.fm/help/destinations/obsidian.md): Snag writes plain markdown into your vault folder. No plugin and no account: the vault is a folder in Files, and Snag only touches the folder you pick.
- [Nextcloud](https://snag.fm/help/destinations/nextcloud.md): Any Nextcloud server. Voice captures and notes go into a folder in Files as the recording and a markdown file. Tasks go to Nextcloud Tasks.
- [Reminders](https://snag.fm/help/destinations/reminders.md): Apple Reminders on this iPhone. Each thing you say you need to do becomes a reminder, with what you said in its notes.
- [Todoist](https://snag.fm/help/destinations/todoist.md): One task for each thing you say you'll do. The full capture rides along as the task's description or a comment.
- [Things](https://snag.fm/help/destinations/things.md): Snag opens Things on the same iPhone to add each capture. No sign-in. It sends while Snag is open and the phone is not locked. Takes voice, notes and tasks.
- [Apple Notes](https://snag.fm/help/destinations/apple-notes.md): Notes has no way in for other apps, so Snag runs your shortcut with what you said, and the shortcut makes the note.
- [Email-in](https://snag.fm/help/destinations/email-in.md): Many apps file mail sent to a private address. Each capture opens a mail to that address in the mail sheet, and you tap Send. It waits until Snag is open.
- [Send to a URL](https://snag.fm/help/destinations/webhook.md): Each capture is posted as JSON to your URL: n8n, Make, Zapier or your own server. Takes voice, notes and tasks: the text, the things to do and the task fields.
- [Snag Control](https://snag.fm/help/control.md): Snag Control is a voice front end for agents you already run: an assistant, an ops agent, a coach.
- [Voice commands](https://snag.fm/help/commands.md): A command is something you say to Snag that isn't for an agent: a phrase, an action, and a reply.
- [Bring your own](https://snag.fm/help/byo.md): Snag works with your own models, transcription, agents and capture backends.
- [Plans](https://snag.fm/help/plans.md): Snag is free to download. Capture is free with no time limit.
- [Privacy](https://snag.fm/help/privacy.md): A summary of what the Snag app does with your words, recordings and keys.
- [Troubleshooting](https://snag.fm/help/troubleshooting.md): Messages are quoted as Snag shows or says them. Where a message names a destination or agent, the name is in angle brackets.
- [FAQs](https://snag.fm/help/faq.md): Snag: Hands-Free Capture, "Agent control, notes and tasks".

## Help for CarPlay

- [CarPlay](https://snag.fm/help/carplay.md): Snag for CarPlay puts capture and Snag Control on the car screen.

## Help for Snag desktop

- [Snag for the desktop](https://snag.fm/help/desktop.md): Snag is a desktop app for quick capture and time tracking. One keypress opens a box that files a task, logs time or adds a note to your Snag account.
- [Installing](https://snag.fm/help/desktop/install.md): Installing Snag desktop on Linux: the system packages, building from source, signing in with a token, starting the daemon and the desktop config.
- [Quick capture](https://snag.fm/help/desktop/capture.md): The capture box is a small window for one line. Type, press Enter, and it is filed to your Snag account.
- [The timer](https://snag.fm/help/desktop/timer.md): One timer runs at a time. It is controlled from keybinds, the tray menu or the timer window, and all three drive the same timer.
- [Idle time](https://snag.fm/help/desktop/idle.md): When there has been no keyboard or mouse input for a while, Snag opens an idle span. When input resumes it asks what that time was.
- [Observation](https://snag.fm/help/desktop/observation.md): Snag can record what is being worked on, so a record exists even on days the timer was forgotten. It is off by default.
- [Time from git history](https://snag.fm/help/desktop/retro.md): snag retro reads the commit history of one or more git repositories, groups commits into sittings and turns them into time entries.
- [Settings](https://snag.fm/help/desktop/settings.md): Snag desktop's settings: the config file, every key and its default, the flags that override it, and the environment variables it reads.
- [Keyboard shortcuts](https://snag.fm/help/desktop/shortcuts.md): Snag desktop's keys: the desktop keybinds that run snag commands, and the keys in the capture box, the timer window, the task picker and the idle prompt.
- [Command line](https://snag.fm/help/desktop/cli.md): Every snag command and flag on the desktop: the daemon, the timer, capture, sign-in, doctor, tasks, retro, observation, and the exit codes.
- [Where data goes](https://snag.fm/help/desktop/data.md): Every file Snag desktop writes on this machine, what it sends to your Snag account and when, and what it never sends.
- [Troubleshooting](https://snag.fm/help/desktop/troubleshooting.md): Fixing Snag desktop: start with snag doctor, then the common problems and their checks, and where the logs are.

## Cheat sheets

- [Snag for iPhone cheat sheet](https://snag.fm/cheatsheet/iphone.md): Snag for iPhone on one page: the Capture and Control tabs, numbered, with the Siri phrases, hands-free replies and agent phrases. Prints on one A4 sheet.
- [Snag in CarPlay cheat sheet](https://snag.fm/cheatsheet/carplay.md): Snag in CarPlay on one page: the car screen's list, numbered, with what to say, the code word steps and what the car never does. Prints on one A4 sheet.
- [Snag desktop cheat sheet](https://snag.fm/cheatsheet/desktop.md): Snag desktop on one page: the capture box and the timer, numbered, with the keybinds, the task line, idle choices and the commands. Prints on one A4 sheet.

## Developers

- [Snag for developers](https://snag.fm/developers.md): Connect your own agents, models and workflows to Snag: the agent API, Talk agents, OpenAI-compatible endpoints, webhooks and commands.
- [Snag agent API](https://snag.fm/developers/agent-api.md): The HTTP API Snag Control calls to reach an agent on your own server.
- [Nextcloud Talk agents](https://snag.fm/developers/talk-agents.md): An agent can live in a Nextcloud Talk room instead of behind its own API. Snag posts what the user says into the room as the user, and reads the agent's reply.
- [OpenAI-compatible and Anthropic endpoints](https://snag.fm/developers/openai-compatible.md): What Snag sends to a model endpoint you bring: an OpenAI-compatible server (OpenAI, Groq, Ollama, LiteLLM, vLLM, a local Whisper server.
- [Webhooks](https://snag.fm/developers/webhooks.md): The two webhooks Snag sends: every capture posted to your URL, and command webhooks signed with Standard Webhooks HMAC, whose reply Snag says.
- [Commands in a repo](https://snag.fm/developers/commands-repo.md): Keep Snag commands, and the agents they call, in a.snag/ folder in a GitHub or GitLab repo.

## Optional

- [Privacy: Snag](https://snag.fm/privacy.md): What snag.fm keeps when you sign up, and what the Snag app does with your voice. In plain words.
- [Terms: Snag](https://snag.fm/terms.md): The terms for the Snag app and Snag Pro: what Free includes, what Pro costs, the trial, renewal and cancelling. In plain words.