FAQ
Everything people ask first
Short answers, written by the person who wrote the app. If something is missing, ask.
Which agents does Hoply support?
Claude Code, Codex CLI and Copilot CLI — state through their hooks, usage through their own records — plus Copilot’s agent in JetBrains, which runs Copilot CLI’s hooks and shows up as Copilot CLI. Qwen Code comes in through OpenTelemetry, and so does Copilot in JetBrains when its agent doesn’t run those hooks. For local inference, any server that speaks OpenAI-compatible or Prometheus: vLLM, tensorfold, llama.cpp, SGLang, TGI, Ollama and LM Studio. Connecting an agent is one button in Settings → Agents.
Do I need an account, and does anything get uploaded?
No account, and nothing is uploaded. Hoply binds its listener to 127.0.0.1 and refuses non-loopback peers. Besides an update check at launch and twice a day, the only request it makes for itself is one call to Anthropic’s usage endpoint with your own Claude login, to fill the Claude limits card. Codex’s limits come from its own session files, with no request at all.
Is my Claude login safe?
Hoply reads the same “Claude Code-credentials” Keychain item Claude Code itself wrote, and only when the Claude limits card is on. macOS asks you once whether that is allowed, and you can deny it — the rest of the app keeps working.
Will Hoply approve things on my behalf?
No. Approve from Hoply is off by default, and when it is on, every Allow or Deny is a click from you with the exact tool and argument shown. Questions and plan approvals are never offered as buttons, because they need your answer.
What does “API-equivalent” mean?
What your tokens would have cost at list prices, including cache reads and writes. Local models cost $0 and are also priced at a reference model you choose, which is the number Hoply shows as saved. A model it does not know is listed as unpriced rather than as free.
Why is Hoply not on the Mac App Store?
The App Store requires the App Sandbox, which would stop Hoply from reading Claude Code’s transcripts and Copilot’s store and session files, writing agent hooks, seeing and stopping the processes agents start, reading the Keychain item for plan limits, and shipping Sparkle updates. A sandboxed build could not do the job.
How do I install it?
Download the universal DMG, drag Hoply to Applications, open it once — or install it with Homebrew: brew install --cask milos5611/hoply/hoply. Either way it updates itself through Sparkle. Release builds are signed with a Developer ID and notarized by Apple, so macOS shows only its usual one-time confirmation for an app downloaded from the internet. It then asks to connect your agents in Settings → Agents.
What does it cost, and what about updates?
Nothing: Hoply is free during early access. Release builds check for updates through Sparkle at launch and twice a day, and show the new version at the bottom of the panel. Settings → Updates turns the check off.
Is Hoply open source?
Yes, under the MIT license. All of Hoply’s code is on GitHub, and the build you download is made from that repository by its public release workflow, so you can read exactly what runs on your Mac. Issues and pull requests are welcome.github.com/Milos5611/hoply
Still unsure? Write to coolcraftcoders@gmail.com — you get a reply from Milos Nikolic, usually the same day.
Try the questions on your own machine
Install it, connect one agent, and see which of your sessions were actually waiting on you.
macOS 14 Sonoma or newer · Apple silicon and Intel · Free during early access