Memory & Skills

Two adjacent sidebar items both deal with what Hermes knows. Memory is the per-conversation and per-user notes Hermes keeps about you. Skills are reusable capabilities you've installed.

Memory

Live editor for Hermes's two memory files:

~/.hermes/memories/MEMORY.md — project / topic memory.
~/.hermes/memories/USER.md — user memory (preferences, role, recurring context).

What you get:

Side-by-side edit + render with markdown preview (Mac); single-pane editor with a "Saved" pill that survives keyboard dismissal + a Revert button (iOS).
Live refresh — when Hermes (or you) updates the file from outside, the view reloads via HermesFileWatcher.
Profile awareness — if you have multiple Hermes profiles, the picker switches between their memory files.
External provider awareness — when memory_provider in config.yaml is set to a service like Honcho or Supermemory, the view tells you so and links to the provider's docs.
Reset memory (v2.5+) — toolbar button on Mac + iOS Memory views that runs hermes memory reset --yes and refreshes the on-screen content. Destructive-confirmation dialog before the call lands. Surfaces stderr in an alert on failure.

Edits are written through ServerContext.writeText — local: atomic temp + swap; remote (Mac): scp + remote mv; remote (iOS): SFTP write via Citadel. See Transport Layer.

Skills

Browse and manage Hermes skills:

Installed — every skill under ~/.hermes/skills/, grouped by category, with a file content viewer and required-config warnings (skill says it needs OPENAI_API_KEY in .env? It tells you).
Hub — search the registry catalog (official, skills.sh, well-known, GitHub, ClawHub, LobeHub). Install, check for updates, uninstall.

Operations are wrappers around the hermes skills CLI invoked via context.runHermes(...), so they work identically against local and remote servers.

v2.6 additions (Hermes v0.12+)

All four are gated on HermesCapabilities.hasCurator / hasSkillURLInstall so a v0.11 host sees the v2.5 surface unchanged.

Autonomous Curator (Mac sidebar + iOS panel). hermes curator self-prunes / -consolidates the skill library on a 7-day cycle. Reports land at ~/.hermes/logs/curator/run.json + REPORT.md; the run path is resolved at runtime from the last_report_path field on ~/.hermes/skills/.curator_state. Mac gets a dedicated Curator sidebar item under Interact (between Memory and Skills); iOS gets a Curator nav row under System with Run Now / Pause / Resume actions and inline pin toggles. Status panel shows enabled/paused/disabled badge, last-run timestamp, last summary, run count, scheduling cadence (interval / stale-after / archive-after). Three leaderboards (least-recently-active / most-active / least-active) with activity / use / view / patch counters. Restore archived sheet calls hermes curator restore <name>. Last-run REPORT.md renders inline in mono.
auxiliary.curator aux task. Curator's review fork can run on a separate model from the main agent. New row in Settings → Auxiliary, gated on hasCuratorAux. Hermes removed auxiliary.flush_memories entirely in v0.12, so Scarf hides that row on v0.12 hosts (inverse gate via hasFlushMemoriesAux). The Tool Gateway health view in HealthView lost the flushMemories-routes-through-Nous row and gained a curator row to match.
Skills v0.12 surface.
- Direct-URL install via hermes skills install <https-url> — Mac SkillsView gains an "Install from URL…" toolbar button opening a sheet with URL field plus optional --category / --name overrides.
- Reload via hermes skills audit — toolbar button next to install on Mac. Equivalent to the /reload-skills slash command for non-ACP contexts.
- Enabled / disabled state — skills.disabled in config.yaml is read at scan time; disabled skills render strikethrough + an "OFF" pill on Mac and iOS rows. iOS detail view explains the state in plain text. The disable-toggle write path is deferred to v2.7 — Hermes only exposes hermes skills config as an interactive verb today, and we'd rather read accurately than risk clobbering a half-tested write.
- Curator pin badge. Pinned skills are protected from auto-archive and rewrites. Pin state is read from ~/.hermes/skills/.curator_state and surfaced as a pin glyph on each row across Mac sidebar and iOS list, plus an explanatory chip on iOS detail view.

v2.5 additions

SKILL.md frontmatter chips. Hermes v0.11 SKILL.md files carry richer YAML frontmatter (allowed_tools, related_skills, dependencies). Scarf parses it on both platforms and renders chip rows in the skill detail view. Old skills without these fields stay nil and the rows hide themselves.
"What's New" pill. Per-server snapshot of [skillId: signature] (file count + sorted file names). When the snapshot changes between visits, both Skills views render a tinted pill at the top: "2 new, 4 updated since you last looked." Tap Mark as seen to update the snapshot. First-time loads silently prime so users don't see "everything is new!" noise on a fresh install. Backed by SkillSnapshotService.
design-md skill prereq banner. The design-md skill needs npx (Node.js 18+) on the host. New SkillPrereqService.probe(binary:) runs which npx over the transport when you open the skill detail; on miss, both Mac and iOS render a yellow banner with a per-OS install hint.
Spotify OAuth sheet. The spotify skill needs OAuth via hermes auth spotify. Mac ships a dedicated Sign-in sheet (mirroring the v2.3 Nous Portal pattern): runs the subprocess, regex-detects the accounts.spotify.com/authorize?... URL, auto-opens it in your browser, polls ~/.hermes/auth.json after subprocess exit to confirm the token landed. Five-state machine (starting → waiting → verifying → success / failure) with retry. iOS surfaces a documentation row noting OAuth needs to happen from Mac or a shell — phone OAuth flows are their own UX problem.

Hermes Paths for the underlying file layout.
Personalities for SOUL.md editing — closely related to memory but tied to a personality, not a profile.
Settings — Memory tab for memory_enabled, memory_char_limit, memory_provider.

Last updated: 2026-05-01 — Scarf v2.6.0 (autonomous Curator, auxiliary.curator aux task, Skills v0.12 surface — URL install / reload / OFF pill / curator pin badge)

Getting Started

ScarfGo (iOS)

User Guide

Architecture

Developer Guide

Reference

Troubleshooting

Slow Chat Startup

Contributing

Release History

Legal & Support

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

Memory & Skills

Memory

Skills

v2.6 additions (Hermes v0.12+)

v2.5 additions

Related pages