gooneyryan/scarf
1
0
Fork 0
mirror of https://github.com/awizemann/scarf.git synced 2026-05-08 02:14:37 +00:00
Code Issues Packages Projects Releases Wiki Activity
Page: Support
Pages
ACP Subprocess Adding a Feature Module Adding a Service Architecture Overview Build and Run Chat Contributing Core Services Dashboard Data Model Design System First Run Gateway Cron Health Logs Hermes Paths Hermes Version Compatibility Home Insights and Activity Installation Keyboard Shortcuts Localization MCP Servers Plugins Webhooks Tools Memory and Skills Performance Monitoring Platform Differences Platforms Personalities QuickCommands Privacy Policy Project Templates Projects and Profiles Release Notes Index Release Process Roadmap ScarfCore Package ScarfGo Onboarding ScarfGo Roadmap ScarfGo Servers and Remote Sidebar and Navigation Slash Commands Support Template Catalog Template Ideas Test Harness Testing Transport Layer Troubleshooting Slow Chat Startup Uninstalling Updating Wiki Maintenance
Clone
1
Support
Alan Wizemann edited this page 2026-04-25 17:47:38 +02:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Support

How to get help with Scarf (macOS) or ScarfGo (iOS), report a bug, request a feature, or disclose a security issue. This page is the Support URL Apple's App Store reviewer follows — it's intentionally simple and link-heavy so anyone landing here from the App Store finds what they need without scrolling.

I'm having trouble using the app

Start with the troubleshooting docs — most issues match a known cause.

Symptom Page to check
ScarfGo can't connect to my Hermes host ScarfGo Onboarding → Troubleshooting
Mac Scarf can't reach a remote server Servers & Remote
Chat hangs or shows "Spinning forever" Chat → Troubleshooting + Slow Chat Startup
Skills hub Browse is empty Hermes Version Compatibility — usually a v2.5+ Citadel exec channel issue, fixed in 2.5
TestFlight says "this beta isn't accepting any new testers" Apple's Beta Review queue is processing the latest build. See ScarfGo — bookmark the page and try again in 24–48h.
Hermes "command not found" over iOS SSH ScarfGo Onboarding — set the Hermes binary hint in the server-edit screen

Bug reports

GitHub Issues is the canonical bug tracker:

github.com/awizemann/scarf/issues

Tag your issue with the right component so it gets routed:

  • component: scarf — Mac app bugs.
  • component: scarfgo — iOS app bugs.
  • component: scarfcore — shared package bugs (services, models, transport).
  • component: design-system — ScarfDesign tokens / components.
  • component: templates — .scarftemplate install / uninstall / catalog issues.
  • component: docs — wiki / README / release-notes corrections.

Include in every report:

  • Scarf version: Settings → General → About (Mac) / System tab → Server section (iOS).
  • Hermes version: hermes --version on the host.
  • macOS / iOS version.
  • Steps to reproduce.
  • Relevant log snippet from ~/.hermes/logs/errors.log (filter sensitive content first).

Feature requests

Same place, different tag:

  • feature: scarf / feature: scarfgo / etc.

Include the use case ("I want to do X because Y") and ⭐ the issue if you'd use the proposed feature — star count is a real input to prioritization.

TestFlight feedback (ScarfGo only)

Open ScarfGo → take a screenshot → use the Send Beta Feedback button TestFlight overlays on your screenshot. The screenshot + your text go straight to the developer along with device + iOS version metadata. This is the right channel for TestFlight build issues (crashes, layout glitches on a specific device, missing strings).

For non-TestFlight-build issues (architectural feature requests, Mac↔iOS parity gaps), GitHub Issues is still the right place.

Security issues

Do not open public GitHub issues for security disclosures. Instead:

I'll acknowledge within 48 hours and coordinate disclosure timing. Standard 90-day disclosure window applies for non-critical issues; immediate coordination for anything affecting credential storage or remote-code-execution surfaces.

Privacy

See Privacy Policy for what data the apps access and what they do not collect. Short version: nothing leaves your device or your Hermes host except over SSH connections you authorize. No analytics, no telemetry, no developer-controlled cloud.

License

Both Scarf and ScarfGo are MIT-licensed. Source: https://github.com/awizemann/scarf.

Direct contact

Email: alan@wizemann.com

Email is for security disclosures, press / partnership inquiries, and "I tried GitHub Issues and the issue was closed but I think you missed something" situations. For everything else, the Issues tracker has more eyes on it and a better chance of someone else hitting the same problem and helping.

Related pages

Last updated: 2026-04-25 — Scarf v2.5.0 (initial publication)

Getting Started

ScarfGo (iOS)

User Guide

Architecture

Developer Guide

Reference

Troubleshooting

Contributing

Release History

Legal & Support

Wiki edited via the local .wiki-worktree/ clone. See Wiki Maintenance for the workflow. Last sync: 2026-04-20.