web + files for apfel

Give apfel the web and your files.

apfel runs Apple's model on-device, so on its own it can't reach the internet or read your files. These four tools do exactly that - and trim every result to fit apfel's 4096-token window.

brew install Arthur-Ficial/tap/apfel-mcp
See it work

45 real runs. Nothing edited.

Every card below is a real apfel --mcp … command run on an Apple Silicon Mac, on-device, on 2026-07-09. The prompt is what was typed; the answer is what apfel returned, verbatim, with the tool's timing.

Honest note: the raw apfel-mcp-ddg-search tool is experimental - DuckDuckGo rate-limited it during this run, so none of the examples use it directly. The compound search-and-fetch (which also searches) worked fine. That's the trade-off the README is upfront about.

How to use it

Install, attach, ask.

You need apfel first (brew install Arthur-Ficial/tap/apfel, macOS 26 + Apple Intelligence).

1

Install

Four commands land on your PATH.

brew install Arthur-Ficial/tap/apfel-mcp
2

Attach a tool with --mcp

apfel runs it as a subprocess and discovers what it offers.

apfel --mcp $(which apfel-mcp-search-and-fetch) \
      "What is the Model Context Protocol?"
3

Ask

The on-device model calls the tool, reads the trimmed result, and answers. For long --chat sessions add --context-strategy sliding-window --context-max-turns 4.

Before you start

What you need.

1.apfel, working. Install it first: brew install Arthur-Ficial/tap/apfel.
2.macOS 26, Apple Silicon, Apple Intelligence on. That's apfel's requirement; apfel-mcp is plain Python.
3.No keys, no cloud. The web tools hit the open web directly; your prompt stays on the Mac.
Why so small? apfel's window is 4096 tokens - a few paragraphs. These tools hand the model a tiny, useful result that fits, instead of a whole page it can't read. That's the design.