Add SOUL.md support and fix window resizing

Author: itsdodobitch

README.md

@@ -28,6 +28,7 @@ host.
 - remote editing for:
   - `~/.hermes/memories/USER.md`
   - `~/.hermes/memories/MEMORY.md`
+  - `~/.hermes/SOUL.md`
 - session browsing from the canonical remote store at `~/.hermes/state.db`
 - fallback to `~/.hermes/sessions/*.jsonl` only if the SQLite store is not
   available
@@ -149,10 +150,10 @@ If `Test` passes, `Use Host` should be on solid ground.
 ## What You Will See In The App
 
 - `Overview`
-  Confirms the remote `HOME`, the Hermes root, the tracked memory files, and
+  Confirms the remote `HOME`, the Hermes root, the tracked Hermes files, and
   the session source.
 - `Files`
-  Lets you edit `USER.md` and `MEMORY.md` on the host.
+  Lets you edit `USER.md`, `MEMORY.md`, and `SOUL.md` on the host.
 - `Sessions`
   Reads the real remote session store from `~/.hermes/state.db`.
 - `Terminal`
@@ -222,9 +223,15 @@ fallback only when the SQLite store is not available.
 
 This is the current direction for the next waves of work:
 
+### Recently Shipped
+
+- [x] richer workflows around the canonical Hermes files: `USER.md`, `MEMORY.md`, and `SOUL.md`
+
+### Next
+
 - skill management views for tracking, inspecting, editing, and organizing agent skills from the app
+- multi-profile support, aligned with Hermes Agent profiles and the app-side connection flow needed to select and use them cleanly
 - UI skins and appearance options to personalize the terminal and the broader chat-like workspace
-- expanded memory tracking, including `SOUL.md` alongside `USER.md` and `MEMORY.md`
 - clearer documentation, setup guides, and troubleshooting for new users
 - easier distribution for non-technical users through signed, notarized builds and, if realistic, App Store or similarly frictionless delivery
 - better first-run onboarding and connection diagnostics so SSH setup problems are easier to understand and fix

Sources/HermesDesktop/App/AppState.swift

@@ -20,6 +20,7 @@ final class AppState: ObservableObject {
     @Published var selectedTrackedFile: RemoteTrackedFile = .memory
     @Published var memoryDocument = FileEditorDocument(trackedFile: .memory)
     @Published var userDocument = FileEditorDocument(trackedFile: .user)
+    @Published var soulDocument = FileEditorDocument(trackedFile: .soul)
     @Published var pendingSectionSelection: AppSection?
     @Published var showDiscardChangesAlert = false
 
@@ -66,7 +67,7 @@ final class AppState: ObservableObject {
     }
 
     var hasUnsavedFileChanges: Bool {
-        memoryDocument.isDirty || userDocument.isDirty
+        memoryDocument.isDirty || userDocument.isDirty || soulDocument.isDirty
     }
 
     func requestSectionSelection(_ section: AppSection) {
@@ -89,6 +90,7 @@ final class AppState: ObservableObject {
     func discardChangesAndContinue() {
         memoryDocument.discardChanges()
         userDocument.discardChanges()
+        soulDocument.discardChanges()
         if let pendingSectionSelection {
             selectedSection = pendingSectionSelection
             handleSectionEntry(pendingSectionSelection)
@@ -342,25 +344,30 @@ final class AppState: ObservableObject {
     }
 
     private func ensureInitialFileLoads() async {
-        await loadTrackedFile(.memory, forceReload: true)
         await loadTrackedFile(.user, forceReload: true)
+        await loadTrackedFile(.memory, forceReload: true)
+        await loadTrackedFile(.soul, forceReload: true)
     }
 
     private func document(for trackedFile: RemoteTrackedFile) -> FileEditorDocument {
         switch trackedFile {
-        case .memory:
-            return memoryDocument
         case .user:
             return userDocument
+        case .memory:
+            return memoryDocument
+        case .soul:
+            return soulDocument
         }
     }
 
     private func setDocument(_ document: FileEditorDocument) {
         switch document.trackedFile {
-        case .memory:
-            memoryDocument = document
         case .user:
             userDocument = document
+        case .memory:
+            memoryDocument = document
+        case .soul:
+            soulDocument = document
         }
     }
 
@@ -396,6 +403,7 @@ final class AppState: ObservableObject {
     private func resetDocuments() {
         memoryDocument = FileEditorDocument(trackedFile: .memory)
         userDocument = FileEditorDocument(trackedFile: .user)
+        soulDocument = FileEditorDocument(trackedFile: .soul)
         selectedTrackedFile = .memory
     }
 

Sources/HermesDesktop/Models/RemoteDiscovery.swift

@@ -19,25 +19,29 @@ struct RemoteDiscovery: Codable {
 }
 
 struct RemoteHermesPaths: Codable {
-    let memory: String
     let user: String
+    let memory: String
+    let soul: String
     let sessionsDir: String
 
     enum CodingKeys: String, CodingKey {
-        case memory
         case user
+        case memory
+        case soul
         case sessionsDir = "sessions_dir"
     }
 }
 
 struct RemoteHermesPathExistence: Codable {
-    let memory: Bool
     let user: Bool
+    let memory: Bool
+    let soul: Bool
     let sessionsDir: Bool
 
     enum CodingKeys: String, CodingKey {
-        case memory
         case user
+        case memory
+        case soul
         case sessionsDir = "sessions_dir"
     }
 }

Sources/HermesDesktop/Models/RemoteTrackedFile.swift

@@ -1,28 +1,33 @@
 import Foundation
 
 enum RemoteTrackedFile: String, CaseIterable, Identifiable {
-    case memory
     case user
+    case memory
+    case soul
 
     var id: String { rawValue }
 
     var title: String {
         switch self {
-        case .memory:
-            "MEMORY.md"
         case .user:
             "USER.md"
+        case .memory:
+            "MEMORY.md"
+        case .soul:
+            "SOUL.md"
         }
     }
 
     var fileName: String { title }
 
     var remoteTildePath: String {
         switch self {
-        case .memory:
-            "~/.hermes/memories/MEMORY.md"
         case .user:
             "~/.hermes/memories/USER.md"
+        case .memory:
+            "~/.hermes/memories/MEMORY.md"
+        case .soul:
+            "~/.hermes/SOUL.md"
         }
     }
 }

Sources/HermesDesktop/Services/RemoteHermesService.swift

@@ -130,22 +130,25 @@ final class RemoteHermesService: @unchecked Sendable {
         try:
             home = pathlib.Path.home()
             hermes_home = home / ".hermes"
-            memory_path = hermes_home / "memories" / "MEMORY.md"
             user_path = hermes_home / "memories" / "USER.md"
+            memory_path = hermes_home / "memories" / "MEMORY.md"
+            soul_path = hermes_home / "SOUL.md"
             sessions_dir = hermes_home / "sessions"
 
             result = {
                 "ok": True,
                 "remote_home": tilde(home, home),
                 "hermes_home": tilde(hermes_home, home),
                 "paths": {
-                    "memory": tilde(memory_path, home),
                     "user": tilde(user_path, home),
+                    "memory": tilde(memory_path, home),
+                    "soul": tilde(soul_path, home),
                     "sessions_dir": tilde(sessions_dir, home),
                 },
                 "exists": {
-                    "memory": memory_path.exists(),
                     "user": user_path.exists(),
+                    "memory": memory_path.exists(),
+                    "soul": soul_path.exists(),
                     "sessions_dir": sessions_dir.exists(),
                 },
                 "session_store": discover_session_store(hermes_home),

Sources/HermesDesktop/Services/Terminal/TerminalSession.swift

@@ -1,8 +1,10 @@
 import Foundation
 
+@MainActor
 final class TerminalSession: ObservableObject, @unchecked Sendable {
     let connection: ConnectionProfile
     let sshArguments: [String]
+    private let viewHost = TerminalViewHost()
 
     @Published var terminalTitle: String
     @Published var currentDirectory: String?
@@ -15,6 +17,11 @@ final class TerminalSession: ObservableObject, @unchecked Sendable {
         self.connection = connection
         self.sshArguments = sshTransport.shellArguments(for: connection)
         self.terminalTitle = connection.label
+        viewHost.bind(session: self)
+    }
+
+    deinit {
+        viewHost.terminate()
     }
 
     func markStarted() {
@@ -39,7 +46,16 @@ final class TerminalSession: ObservableObject, @unchecked Sendable {
         launchToken = UUID()
     }
 
+    func mount(in container: TerminalMountContainerView, isActive: Bool) {
+        viewHost.mount(in: container, session: self, isActive: isActive)
+    }
+
+    func unmount(from container: TerminalMountContainerView) {
+        viewHost.unmount(from: container)
+    }
+
     func stop() {
+        viewHost.terminate()
         isRunning = false
         currentDirectory = nil
     }