Files are the app

ID: cap-files-are-the-app · Type: capability

Capability

Files are the app

Hermit keeps prompts, records, workflows, and UI in one repo instead of hiding state behind a separate backend

The repo is the application: data, behavior, UI, and operating state live together as files with git history.

At a glance

Audience
Builders who want inspectable, local-first systems
Owner
Hermit Website Lead
Status
active

Proof points

  • The workspace stores roles, prompts, skills, entities, and agent state directly on disk.
  • Entity definitions and templates declare the schema in markdown under entity-defs/.
  • The Astro explorer renders the same workspace the CLI and agents use.

Details

Summary

Hermit is built so the working system stays visible. Instead of splitting prompts, state, UI, and runtime logic across hidden services, it keeps the important pieces together in the repo.

Why It Matters

That makes the system easier to inspect, version, shape, and extend. It also lets the agent improve the same machinery it operates.

Demo Ideas

  • Show the entity definitions beside the rendered explorer view.
  • Show a role prompt change and the resulting behavior change.