FAQ

Do I need the cloud, or can I work locally?

Both. There are 22 presets; Ollama, LM Studio, vLLM, SGLang and any OpenAI-compatible server use the same assistant as Grok or Claude. Spend is counted from sessions on your disk. If the model is on your machine, nothing leaves it unless you asked.

What is the difference between a pack and a package?

A pack is a work domain: a packs/ directory with a manifest, injectable context, skills and prompts. That is what the radar detects and what you enable with /domains. A package is something you install: pi install, the gallery or /essentials. Packs ship inside the Alfred-Pi package. Recommended packages of each pack install separately, with a prior audit. Nothing installs in silence.

Are Chrome-for-improve and e2e tests the same thing?

No, and the difference matters. e2e-testing writes the Playwright suite that runs in CI. browser-improve drives Chrome over CDP to measure and fix the live page. One writes the contract that checks itself; the other looks at the page with your eyes. Neither drives your Chrome without leave.

I am on 0.2.x: what happens at 0.3.0?

The house moves without losing the furniture. First start after updating looks for ~/.pi/agent/alfred-pi/. If it is missing and pi-harness-moe/ exists, it copies it, does not move it, and leaves migrated-from.json with the date. pi's native files are not touched. The origin is not deleted in 0.3.0.

My scripts still use --harness-moe. Do they work?

In 0.3.0, yes. The old flag answers for a full cycle and the doctor warns that the canonical flag is --alfred-pi. In 0.4.0 the alias is removed. Flag values do not change.

Does Alfred-Pi remember things across sessions?

Only if you ask, per project, with .alfred-pi/memory-policy.json containing{ "allow": true }. If the file is missing, memory is off. It never turns itself on.

Does the budget cut me off?

No. At 80% it warns once a day; at 100% it adds a frugality note. It watches and modulates. It never blocks a turn. Relay hops on provider failure, between turns, not on price.

What is pi, and where do I get it?

pi is the terminal agent Alfred-Pi installs on. Without pi there is no extension to load. Official install is at pi.dev; Alfred needs 0.84 or later. If you already have it, the hero command and a /reload are enough.

Is it a Claude Code clone?

No. Claude Code is another vendor's full agent. Alfred-Pi is the product layer on pi, the host you already have.

What does it cost?

Alfred-Pi is MIT and free. You pay the models you use, to the provider you choose, with keys you keep. There is no studio cloud account.