Support for Loom.
Loom is a local Mac app for reading and thinking. If something fails, the fastest useful report is concrete and short.
Report an Issue
Open an issue at github.com/Yiping-Yin/Wiki/issues, or email yiping_yin0521@outlook.com. I read every message and reply within two working days.
Please include:
- Your macOS version
- The Loom app version (Loom → About Loom) and bundle identifier
com.yinyiping.loom - What you were trying to do
- Any visible error message
- Whether the issue involved AI provider settings or local files
- Most recent file from
~/Library/Logs/Loom/if the app crashed
Common Questions
Which macOS versions does Loom run on?
macOS 14 (Sonoma) and later. Loom is built for Apple Silicon and runs natively.
Do I need an API key to use Loom?
No. Loom works as a reading surface without AI. If you want the margin weaver, rehearsal, or examiner features, pick a provider in Settings → AI Provider: Anthropic, OpenAI, Ollama (local), or a custom HTTPS endpoint. Keys stay in the macOS Keychain.
Which file types can I drop in?
PDF, Word (.docx, .doc), Rich Text (.rtf, .rtfd), and plain text or Markdown (.md, .mdx, .txt, .markdown).
Loom can't see my folder. What do I do?
macOS sandboxing means Loom only reads folders you explicitly grant access to. Open Settings → Data and pick your sources folder again — Loom will remember it across launches via a security-scoped bookmark.
My Ollama isn't answering. Why?
Open Settings → AI Provider and confirm the host and model. Ollama defaults to http://127.0.0.1:11434; make sure Ollama is running (ollama serve) and the model you picked has been pulled (for example, ollama pull llama3).
Why is "Claude CLI" or "Codex CLI" greyed out?
In the Mac App Store build, sandbox rules block Loom from spawning local command-line binaries. HTTPS providers (Anthropic, OpenAI, a custom endpoint) and the local Ollama HTTP API remain available.
Where does Loom store my data?
Reading traces and held panels live in ~/Library/Application Support/Loom/. Your source files stay exactly where you put them — Loom never moves or rewrites the originals.
How do I delete everything Loom has learned?
Settings → Data → Wipe all Loom data clears Loom preferences and web storage. To remove traces, panels, weaves, and every sandboxed database, delete ~/Library/Containers/com.yinyiping.loom. Remove API keys from Settings → AI Provider, or delete the com.yinyiping.loom entries in Keychain Access.
Privacy
For data handling details, read the Loom privacy policy.
Last updated 2026-04-24.