Skip to main content

Configuration

All runtime data lives in ~/.mercury/ — not in your project directory.

PathPurpose
~/.mercury/mercury.yamlMain config (providers, channels, budget)
~/.mercury/soul/*.mdAgent personality (soul, persona, taste, heartbeat)
~/.mercury/permissions.yamlCapabilities and approval rules
~/.mercury/skills/Installed skills
~/.mercury/schedules.yamlScheduled tasks
~/.mercury/token-usage.jsonDaily token usage tracking
~/.mercury/memory/Short-term, long-term, episodic memory
~/.mercury/daemon.pidBackground process PID
~/.mercury/daemon.logDaemon mode logs