Your Agent’s Brain on Disk
Everything Wolffish knows, remembers, and can do lives in~/.wolffish/workspace/. This is your agent’s brain on disk — readable, editable, and git-versionable.
Directory Structure
Key Principles
Files are truth,cortex.db is cache. The SQLite database indexes everything above — episodes, knowledge, conversations (every message and tool call), task runs, feedback, usage, logs, and artifact metadata — and is fully disposable: delete it and Wolffish rebuilds it from the source files. A normal launch brings it current with an incremental mtime/size diff (~22ms); a full rebuild happens only when the index schema version bumps (~1.3 seconds for a 2GB workspace), never on every launch. Never edit cortex.db directly — edit the source files instead.
Daily files over growing files. Episodes, feedback, and event logs are split by day (YYYY-MM-DD.md). This keeps individual files small, makes them easy to browse, and allows the brainstem to clean up old logs automatically.
Capabilities are self-contained. Each folder under brain/cerebellum/ is a complete capability. You can delete any of them without affecting the core system. You can add new ones by dropping in a folder.
Inspecting the Workspace
Wolffish includes a built-in file viewer and markdown editor — you can browse and edit your entire workspace without leaving the app. For most use cases, it’s all you need. You can also open~/.wolffish/workspace/ in any external editor if you prefer. Some useful things to inspect:
Version Control
You cangit init the workspace directory to version-control your agent’s brain. This lets you track changes to personality, review memory evolution, roll back configuration changes, and share your agent setup with others.