@brimveyn/aimux 1.2.5 → 1.3.0

package/README.md

@@ -21,7 +21,7 @@ A terminal multiplexer for AI CLIs. Manage multiple AI assistant sessions (Claud
 - **Directory picker** — Fuzzy-search git repos and worktrees from `$HOME` using `fzf`
 - **Session persistence** — Workspace state (tabs, titles, layout) saved and restored on restart
 - **Git status panel** — Branch + diff summary in the sidebar
-- **Daemon mode** — Background daemon keeps sessions alive across terminal restarts
+- **Seamless daemon updates** — A restartable IPC daemon now reconnects to a long-lived terminal manager, so updates and IPC changes do not kill live tabs
 - **Snippets** — Save and reuse prompt snippets across sessions
 - **Theme picker** — Switch between 11 built-in themes on the fly
 - **Pending-chord indicator** — Bottom-right overlay shows mid-sequence key state (like nvim's `which-key`)
@@ -58,20 +58,22 @@ aimux                  # start the TUI
 aimux version          # print version
 aimux doctor           # check setup
 aimux update           # self-update
-aimux restart-daemon   # restart background daemon
+aimux restart-daemon   # restart IPC daemon only
 ```
 
+`aimux update` and `aimux restart-daemon` restart only the IPC daemon. Live PTYs and headless terminal state stay in the long-lived terminal-manager process, so active tabs can be reattached instead of being restarted.
+
 ## Configuration
 
-aimux reads `~/.config/aimux/aimux.config.ts` at startup. Set it up with:
+aimux reads `~/.config/aimux/<profile>/aimux.config.ts` at startup. The default installed profile is `default`, while the repository dev scripts use `dev`. Set up the default profile with:
 
 ```bash
-mkdir -p ~/.config/aimux && cd ~/.config/aimux
+mkdir -p ~/.config/aimux/default && cd ~/.config/aimux/default
 bun init -y
 bun add -d @brimveyn/aimux-config
 ```
 
-Then create `~/.config/aimux/aimux.config.ts`:
+Then create `~/.config/aimux/default/aimux.config.ts`:
 
 ```ts
 import { defineConfig, actions, themes } from '@brimveyn/aimux-config'
@@ -158,6 +160,14 @@ Keystrokes pass through to the active tab's PTY. Configured shortcuts:
 
 ## Architecture
 
+Runtime split:
+
+- `aimux` UI connects to the IPC daemon over the app protocol.
+- The IPC daemon owns the app-facing socket, protocol negotiation, and reconnect behavior.
+- The terminal manager owns PTYs, xterm headless emulators, and live session state.
+
+This split lets the app or IPC daemon change protocols without dropping live shells.
+
 ```
 aimux/
 ├── packages/
@@ -171,9 +181,10 @@ aimux/
     ├── ui/                    # OpenTUI React components
     ├── state/                 # reducers + app store
     ├── pty/                   # PTY and terminal emulation
-    ├── session-backend/       # local and daemon backends
-    ├── daemon/                # background session daemon
-    ├── ipc/                   # daemon protocol
+    ├── session-backend/       # local and remote backends
+    ├── daemon/                # IPC daemon / broker
+    ├── terminal-manager/      # long-lived PTY/session owner
+    ├── ipc/                   # app and manager protocols
     └── input/
         ├── modes/             # mode registry + transitions
         ├── keymap/            # prefix trie + sequence resolver
@@ -201,6 +212,16 @@ bun run check            # typecheck
 bun run lint             # oxlint
 ```
 
+By default the app talks to the background IPC daemon. For explicit single-process debugging only, set `AIMUX_LOCAL_BACKEND=1` before starting aimux.
+
+Profiles live under `~/.config/aimux/<profile>/`. Each profile gets its own config, session catalog, snippet catalog, and matching runtime namespace.
+
+The repository `bun run dev`, `bun run start`, and `bun run restart-daemon` scripts set `AIMUX_PROFILE=dev`, so source builds use `~/.config/aimux/dev/` and their own IPC daemon / terminal-manager sockets instead of interfering with a globally installed `aimux` instance.
+
+You can override the active profile manually with `AIMUX_PROFILE=<name>` when you need multiple isolated environments on the same machine. `AIMUX_RUNTIME_PROFILE` is still accepted as a fallback alias for runtime compatibility.
+
+This profile move is intentionally breaking: aimux no longer reads legacy flat config or catalog files once profile directories are enabled.
+
 ## License
 
 MIT © BrimVeyn

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brimveyn/aimux",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "A terminal multiplexer for AI CLIs. Run Claude, Codex, OpenCode side-by-side with tabbed navigation, split panes, and persistent sessions.",
   "keywords": [
     "ai",
@@ -42,8 +42,8 @@
     "access": "public"
   },
   "scripts": {
-    "dev": "bun --watch src/index.tsx",
-    "start": "bun run src/index.tsx",
+    "dev": "AIMUX_PROFILE=dev bun --watch src/index.tsx",
+    "start": "AIMUX_PROFILE=dev bun run src/index.tsx",
     "test": "bun test",
     "check": "tsc --noEmit",
     "demo": "vhs assets/demo.tape",
@@ -51,7 +51,7 @@
     "demo:tabs": "vhs assets/tabs.tape",
     "demo:splits": "vhs assets/splits.tape",
     "demo:themes": "vhs assets/themes.tape",
-    "restart-daemon": "bun run src/index.tsx restart-daemon",
+    "restart-daemon": "AIMUX_PROFILE=dev bun run src/index.tsx restart-daemon",
     "lint": "oxlint .",
     "format": "oxfmt --write .",
     "format:check": "oxfmt --check ."

package/src/app-runtime/backend-runtime-events.ts

@@ -3,6 +3,7 @@ import type { MutableRefObject } from 'react'
 import type { SessionBackend } from '../session-backend/types'
 import type { AppAction, TabSession, TerminalModeState } from '../state/types'
 
+import { logInputDebug } from '../debug/input-log'
 import { type TabRuntimeTimeouts } from './tab-runtime-timeouts'
 
 const IDLE_ACTIVITY_TIMEOUT_MS = 2_000
@@ -44,6 +45,12 @@ export function bindBackendRuntimeEvents({
       return
     }
 
+    logInputDebug('app.backend.event.render', {
+      lines: viewport.lines.length,
+      tabId,
+      viewportY: viewport.viewportY,
+    })
+
     dispatch({ tabId, terminalModes, type: 'replace-tab-viewport', viewport })
     if (timeouts.isStartupGraceActive(tabId) || resizingRef.current) {
       return
@@ -54,12 +61,14 @@ export function bindBackendRuntimeEvents({
   }
 
   const handleExit = (tabId: string, exitCode: number) => {
+    logInputDebug('app.backend.event.exit', { exitCode, tabId })
     clearTabRuntimeState(timeouts, tabId)
     dispatch({ exitCode, status: 'exited', tabId, type: 'set-tab-status' })
     dispatch({ activity: undefined, tabId, type: 'set-tab-activity' })
   }
 
   const handleError = (tabId: string, message: string) => {
+    logInputDebug('app.backend.event.error', { message, tabId })
     clearTabRuntimeState(timeouts, tabId)
     dispatch({ message, tabId, type: 'set-tab-error' })
   }

package/src/app-runtime/side-effects.ts

@@ -245,6 +245,14 @@ export function startTabSession(
   rows: number,
   cwd?: string
 ): void {
+  logInputDebug('app.tab.start.request', {
+    cols,
+    command: tab.command,
+    cwd: cwd ?? null,
+    rows,
+    tabId: tab.id,
+    title: tab.title,
+  })
   startStartupGrace(tab.id)
 
   const { args, executable } = parseCommand(tab.command)

package/src/config/loader.ts

@@ -1,8 +1,8 @@
 import { type AimuxUserConfig, resolveConfig, type ResolvedConfig } from '@brimveyn/aimux-config'
-import { homedir } from 'node:os'
 import { join } from 'node:path'
 
 import { logDebug } from '../debug/input-log'
+import { getProfileConfigDir } from '../profile-paths'
 
 const CONFIG_FILENAMES = ['aimux.config.ts', 'aimux.config.js']
 
@@ -11,7 +11,7 @@ const CONFIG_FILENAMES = ['aimux.config.ts', 'aimux.config.js']
  * a resolved config. Falls back to pure defaults if no config file exists.
  */
 export async function loadUserConfig(): Promise<ResolvedConfig> {
-  const configDir = join(homedir(), '.config', 'aimux')
+  const configDir = getProfileConfigDir()
 
   for (const filename of CONFIG_FILENAMES) {
     const configPath = join(configDir, filename)

package/src/config.ts

@@ -1,13 +1,13 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
 
 import type { WorkspaceSnapshotV1 } from './state/types'
 
 import { logDebug } from './debug/input-log'
+import { getProfileConfigDir } from './profile-paths'
 import { isWorkspaceSnapshotV1 } from './state/validation'
 import { THEME_IDS, type ThemeId } from './ui/themes'
 
-export const CONFIG_PATH = join(process.env.HOME ?? '~', '.config', 'aimux.json')
+export const CONFIG_PATH = `${getProfileConfigDir()}/aimux.json`
 
 export interface AimuxConfig {
   version: 2
@@ -133,7 +133,7 @@ export function loadConfig(): AimuxConfig {
 
 export function saveConfig(config: AimuxConfig): boolean {
   try {
-    mkdirSync(dirname(CONFIG_PATH), { recursive: true })
+    mkdirSync(getProfileConfigDir(), { recursive: true })
     writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`)
     return true
   } catch (error) {