↓ Skip to main content
  1. Blog/

PocketHook 1.3: more context for your agent

·5 mins
PocketHook 1.3: a photo, a document and a saved result alongside the app icon

You have a PDF in Files, an image you need to understand, or a webpage you want to discuss with your agent. Getting that context into a conversation could mean copying, describing and switching apps. PocketHook 1.3 expands what you can send and receive, so you can start with the content already in front of you.

The update arrives alongside Agent Server 0.7.0. Beyond attachments and the share sheet, it improves delivery of pending results and makes Apple Bridge easier to set up on a Mac. Your server and the model behind it remain your choice.

Update PocketHook on the App Store

Share from wherever you are
#

The iOS share sheet is now another way to reach your agent. In a compatible app, choose PocketHook to send text, links, images or documents without composing the message in the chat first.

For example, share a page from Safari to ask for a summary, or send a PDF from Files and ask about the sections that matter to you. The content and your request go to the server configured in PocketHook. What the agent can do with them depends on that server’s tools and model.

This also fits alongside your existing Shortcuts workflows: keep your automations, and use the share sheet when the content you need is open in another app.

A photo or document can start the conversation
#

Version 1.3 adds image and document attachments. A screenshot can explain an error; a PDF can supply the material you want summarized; a text file or CSV can hold the data you need to work with.

Agent Server 0.7.0 accepts common image formats, PDF, text, CSV, Markdown and JSON. Interpreting an image requires a model with vision support, and document processing depends on the server’s capabilities. PocketHook gets the file there so you can ask questions about it.

Three things to try:

  • Understand a screenshot: attach an image and ask, “What does this error mean?”
  • Prepare for a meeting: share a document and ask for a summary of the points worth discussing.
  • Review a table: send a CSV and ask your agent to identify missing data.

Attaching a file uploads it to your server. Images and text extracted from documents may also reach your configured model provider. Supported formats, limits and file retention are covered in the 1.3 compatibility guide.

Your results wait for you
#

Some requests take longer than a chat exchange. You can send them from a Shortcut without waiting for completion and get on with your day. For that workflow, PocketHook 1.3 and Agent Server 0.7.0 add acknowledged result delivery.

When a job finishes, the server keeps its result. PocketHook retrieves it and saves it in the chat, then confirms receipt. If the connection drops before confirmation, the result remains available to collect again. The app recognizes messages it has already saved to avoid duplicates.

That matters for an everyday sequence: start a request, switch apps and come back later. The server no longer treats a result as delivered just because it sent it. Results are collected when PocketHook communicates with the server again.

From a response to an app, or to your photos
#

Server responses can include links to other apps. If the destination app is installed and supports the link, tap it to continue there. It gives you a direct path from a result to your next action.

There are also links that open a query of your local photo library, such as showing your latest photos. Enable the feature in PocketHook and grant the relevant permission first.

Opening one of these links does not upload your photos to the server. Selecting a photo and attaching it to the chat does. You can browse your library and then decide which image to bring into the conversation.

Apple Bridge is easier to set up
#

If your Agent Server uses a Mac, this release includes commands to install Apple Bridge 0.6.0, generate its pairing code and check its status. The companion lets your agent work with Calendar, Reminders and Contacts: for example, looking up events or creating a reminder, subject to the available capabilities and the permissions you grant in macOS.

The package is signed and notarized. It installs as a separate companion and pairs with your server through a single-use code. The Safari extension keeps its own pairing process: each companion is configured separately.

Find the commands and downloads in the companion setup guide.

What to update
#

Start with PocketHook 1.3 on the App Store. If you use our server, update to Agent Server 0.7.0 for attachments and persistent results. Apple Bridge is optional; install it only if you want its Mac capabilities.

If you already run your own webhook, it can continue handling chat and direct responses. The new file and delivery features require that server to implement the relevant capabilities. For developers, PocketHook SDK 0.1.3 and the protocol documentation accompany this release.

PocketHook still connects to the endpoint you choose, with the provider and model you configure. Version 1.3 gives you more ways to supply context and pick up your agent’s work within that same setup.

Download PocketHook · Set up Agent Server · Read the full 1.3 requirements

Alfonso J. Menkel
Alfonso J. Menkel
CEO & Founder