Projects and Profiles

Projects & Profiles

Two distinct concepts in adjacent sidebar items. Projects are agent-generated dashboards for any directory. Profiles are isolated Hermes installations.

Projects

A project is any directory you tell Scarf about — typically a code repo, but anything works. Each project gets a custom dashboard composed of widgets defined in <project>/.scarf/dashboard.json.

Widget types (from ProjectDashboard.swift):

Type	Purpose
stat	Single metric: value + label + optional icon and color.
progress	Progress bar with label.
text	Markdown / plain text block.
table	Columns + rows.
chart	Line / bar / area / pie with ChartSeries[] of ChartDataPoint{x, y}.
list	Bulleted list with optional status badges.
webview	Embedded web view (URL + height).

The Hermes pattern: ask your agent to build and maintain the dashboard for you. "Update .scarf/dashboard.json to show test pass rate, lines of code, and the open PR list." Scarf renders the result; the agent maintains it.

The full schema is documented in scarf/docs/DASHBOARD_SCHEMA.md in the main repo.

Adding a project: click + in the Projects sidebar, pick a directory. The project is registered in ~/.hermes/scarf/projects.json; the dashboard JSON lives in <project>/.scarf/dashboard.json (which you should add to your project's .gitignore if it's user-specific).

Profiles

A profile is an isolated Hermes installation — separate config, sessions, memory, skills, the lot. Useful for keeping work / personal context separate, or for testing a config change without disturbing your main instance.

Operations (all wrap hermes profile ... via context.runHermes):

• Switch — make a profile active. Scarf shows a "restart Scarf to fully apply" reminder because the active profile path is read at launch.
• Create / rename / delete — straightforward.
• Export — zips the profile directory; useful for backup or moving to a new machine.
• Import — unzip into a new profile slot.

Profiles live under ~/.hermes/profiles/. The currently active profile is whatever Hermes points its ~/.hermes/ symlink (or equivalent) at — Scarf reflects that.

Related pages

• Hermes Paths — ~/.hermes/profiles/ and the projects registry.
• Memory & Skills — memory is profile-scoped.
• Settings — exposes "Backup & Restore" buttons (hermes backup / hermes import) at the profile level.

---

Last updated: 2026-04-20 — Scarf v2.0.1