heartcode 0.1.24 → 0.1.25

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 What changed in each version of HeartCode, newest first.
 
+## 0.1.25 (2026-10-31)
+
+- The model(s) you choose for a folder with /select_model are remembered per folder, in
+  .heartcode/models.json, and restored when you open that folder again; auto stays auto (the file
+  is removed). A -m model on the command line still wins for that run.
+- The status bar and the working spinner use two lines instead of cramming everything onto one: the
+  status shows the model and what it can do on one line, the run's stats and controls on the next;
+  the spinner shows what it's doing, with the elapsed time and Esc on the line below.
+- When a chosen set or auto rotates to a fallback (the model answering now isn't your first/preferred
+  one, because it failed), the status bar marks that model with a yellow "↻" so you can see at a
+  glance it came after rotating. No rotation, or back on the first model: no marker.
+
 ## 0.1.24 (2026-10-31)
 
 - A pinned model (one picked with /select_model, or -m) is now used by the helpers it spawns too:

package/bin/heartcode.js

@@ -168,6 +168,23 @@ class App {
     this.director = new Director(this) // the manage tool: skills, MCP servers and settings by asking
     this.later = [] // setting changes that wait until the current message is done
     this.failures = {} // "provider model" → failed requests this session (engine: onFail)
+    this.loadProjectModels() // the model(s) you last chose for this folder (.heartcode/models.json)
+  }
+
+  // Per folder: the model set you picked with /select_model, remembered in .heartcode/models.json and
+  // restored when you open this folder again. Absent/empty means auto (your whole list). A -m model
+  // from the command line (cfg.session already set) wins and isn't overwritten.
+  loadProjectModels() {
+    if (this.cfg.session) return
+    const saved = readJson(path.join(this.root, '.heartcode', 'models.json'), null)
+    const valid = (saved?.session ?? []).filter((t) => t?.provider && t?.model && this.cfg.providers[t.provider])
+    if (valid.length) this.cfg.session = valid
+  }
+
+  saveProjectModels() {
+    const file = path.join(this.root, '.heartcode', 'models.json')
+    if (this.cfg.session?.length) writeJson(file, { session: this.cfg.session.map((t) => ({ provider: t.provider, model: t.model })) })
+    else fs.rmSync(file, { force: true }) // auto: forget the folder's choice
   }
 
   newMcp() {
@@ -593,39 +610,42 @@ class App {
     // one model (pinned): just its name. Several chosen for this session: the one in use + "N chosen".
     // Your whole list (auto): "auto (in use) (N)". ↻ shows the rotation position while rotating.
     const count = this.sessionModels().length
-    const spin = rot ? c.faint(` ↻ ${rot.at + 1}/${rot.list.length}`) : ''
+    // the model answering now; a "↻" before it, in yellow, when it's a fallback (rotated to after one
+    // failed) — so you can see at a glance it isn't the first/preferred one
+    const rotated = rot && rot.at > 0
+    const name = rotated ? `${c.yellow('↻ ' + now.model)}` : c.info(now.model)
     const model =
       count === 1
-        ? c.info(now.model)
+        ? name
         : cfg.session
-          ? `${c.info(now.model)} ${c.faint(`(${count} chosen)`)}${spin}`
-          : `${c.muted('auto')} ${c.faint('(')}${c.info(now.model)}${c.faint(')')} ${c.faint(`(${count})`)}${spin}`
-    const parts = [`${c.brand('●')} ${c.muted(now.provider)} ${c.faint(`(${on})`)} ${c.ghost('·')} ${model}`]
+          ? `${name} ${c.faint(`(${count} chosen)`)}`
+          : `${c.muted('auto')} ${c.faint('(')}${name}${c.faint(')')} ${c.faint(`(${count})`)}`
+    // two lines so nothing is crammed: the model and what it can do, then the run's stats and controls
+    const first = [`${c.brand('●')} ${c.muted(now.provider)} ${c.faint(`(${on})`)} ${c.ghost('·')} ${model}`]
+    const second = []
     const key = `${now.provider}/${now.model}`
     if (this.profileKey !== key) [this.profileKey, this.profile] = [key, this.s?.profile ?? loadProfile(this.client(now.provider, now.model))]
     const profile = this.s?.profile ?? this.profile
     if (profile) {
       const strat = this.s?.strat ?? strategy(profile, cfg)
-      parts.push(c.muted(strat.actions === 'tools' ? 'tools' : 'guided'))
-      if (strat.thinking) parts.push(c.think(`thinking${cfg.effort ? ` · ${cfg.effort}` : ''}`) + (ui.showThinking ? '' : c.faint(' (collapsed)')))
-      if (strat.vision) parts.push(c.muted('images'))
+      first.push(c.muted(strat.actions === 'tools' ? 'tools' : 'guided'))
+      if (strat.thinking) first.push(c.think(`thinking${cfg.effort ? ` · ${cfg.effort}` : ''}`) + (ui.showThinking ? '' : c.faint(' (collapsed)')))
+      if (strat.vision) first.push(c.muted('images'))
       const used = this.s?.client.lastTokens ?? 0
       const pct = Math.round((used / strat.context) * 100)
       const paint = pct >= 80 ? c.red : pct >= 50 ? c.yellow : c.green
       const guess = strat.contextSure ? '' : '~' // not said by the server: assumed, and growing as bigger requests work
-      parts.push(`${c.faint('ctx')} ${paint(`${kTokens(used)}/${guess}${kTokens(strat.context)}`)} ${c.faint(`${pct}%`)}`)
+      second.push(`${c.faint('ctx')} ${paint(`${kTokens(used)}/${guess}${kTokens(strat.context)}`)} ${c.faint(`${pct}%`)}`)
       const tps = this.s?.client.tps
-      if (tps) parts.push(`${c.muted(String(tps))} ${c.faint('tok/s')}`)
-      if (this.chat.usage?.priced) parts.push(c.muted(money(this.chat.usage.cost)))
+      if (tps) second.push(`${c.muted(String(tps))} ${c.faint('tok/s')}`)
+      if (this.chat.usage?.priced) second.push(c.muted(money(this.chat.usage.cost)))
     } else {
-      parts.push(c.dim('not probed yet'))
+      first.push(c.dim('not probed yet'))
     }
-    if (cfg.autoCompact === false) parts.push(c.faint('auto-compact off'))
-    if (this.worktree) parts.push(c.info(`⎇ ${this.worktree.branch}`))
-
-    const perm = { all: c.green('⏵⏵ all allowed'), commands: c.yellow('ask before commands'), ask: c.yellow('ask before changes'), plan: c.info('⏸ plan mode') }[ui.permission]
-    parts.push(perm) // Shift+Tab changes it (see the header)
-    return parts.join(sep)
+    if (cfg.autoCompact === false) second.push(c.faint('auto-compact off'))
+    if (this.worktree) second.push(c.info(`⎇ ${this.worktree.branch}`))
+    second.push({ all: c.green('⏵⏵ all allowed'), commands: c.yellow('ask before commands'), ask: c.yellow('ask before changes'), plan: c.info('⏸ plan mode') }[ui.permission]) // Shift+Tab changes it
+    return [first.join(sep), second.join(sep)].filter((l) => l.replace(/\x1b\[[0-9;]*m/g, '').trim()).join('\n')
   }
 
   client(name, model) {
@@ -771,20 +791,23 @@ class App {
     return cfg.session.filter((t) => cfg.providers[t.provider] && (all || !cfg.providers[t.provider].off) && t.model && !seen.has(`${t.provider}/${t.model}`) && seen.add(`${t.provider}/${t.model}`))
   }
 
-  // Use a chosen set of models for this session (session-local, not saved): one pins it (no
-  // rotation), several rotate among just those. The saved ranking (settings page / auto) is untouched.
+  // Use a chosen set of models for this session: one pins it (no rotation), several rotate among
+  // just those. Remembered for this folder (.heartcode/models.json); the saved ranking is untouched.
   async setSession(list) {
     const { cfg } = this
-    cfg.session = list // only here; cfg.provider/model stay your global #1, so your whole list and the picker are unchanged
+    cfg.session = list // the global #1 (cfg.provider/model) stays, so your whole list and the picker are unchanged
+    this.saveProjectModels()
     this.s = null
-    this.ui.print(list.length === 1 ? `${c.green('using')} ${c.cyan(list[0].model)} ${c.dim('· pinned for this session')}` : `${c.green(`using ${list.length} models this session`)}: ${c.cyan(list.map((t) => t.model).join(', '))}`)
+    this.ui.print(list.length === 1 ? `${c.green('using')} ${c.cyan(list[0].model)} ${c.dim('· pinned for this folder')}` : `${c.green(`using ${list.length} models for this folder`)}: ${c.cyan(list.map((t) => t.model).join(', '))}`)
     await this.session()
   }
 
-  // Back to auto: your whole list again (#1, then the next when one fails), following the saved ranking.
+  // Back to auto: your whole list again (#1, then the next when one fails), following the saved
+  // ranking. The folder's remembered choice is cleared.
   async auto() {
     const { cfg } = this
-    delete cfg.session // back to your whole list (cfg.provider/model + the ranking)
+    delete cfg.session
+    this.saveProjectModels()
     this.s = null
     this.ui.print(`${c.green('using')} ${c.dim('auto')} ${c.cyan(`(${this.myModels().length} models)`)}`)
     await this.session()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heartcode",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "A coding CLI for any local or OpenAI-compatible model, including small models without tool calling.",
   "keywords": [
     "ai",

package/src/ui.js

@@ -885,15 +885,14 @@ export class UI {
     const hiddenBelow = input.rows.length - first - box.length
     const rule = c.ghost('─'.repeat(cols))
     const note = (n, arrow) => c.ghost('── ') + c.faint(`${arrow} ${n} more line${n > 1 ? 's' : ''}`) + c.ghost(` ${'─'.repeat(Math.max(0, cols - 18 - String(n).length))}`)
-    const below = [hiddenBelow ? note(hiddenBelow, '↓') : rule, ...(this.status ? [fit(' ' + this.status(), cols)] : [])] // under the input
+    const below = [hiddenBelow ? note(hiddenBelow, '↓') : rule, ...(this.status ? this.status().split('\n').map((l) => fit(' ' + l, cols)) : [])] // the status bar, one line or more
     const bottom = []
     if (this.timer && !this.asking) {
-      // how long it's been at this message, and (while waiting on the model) since this request was sent
+      // the spinner on its own line; the timer (and Esc) on the next, so neither line is crammed
       const request = this.requestSince?.()
       const timer = this.busySince ? `responding ${duration(this.worked())}${request ? ` · waiting for model ${duration(Date.now() - request)}` : ''} · Esc to stop` : ''
-      const retrying = this.beforeRetry !== undefined // the label is the retry message: its own line, timer below
-      bottom.push(fit(`${c.brand(FRAMES[this.frame % FRAMES.length])} ${c.muted(this.#label())}${retrying || !timer ? '' : c.faint(` · ${timer}`)}`, cols))
-      if (retrying && timer) bottom.push(fit(`  ${c.faint(timer)}`, cols))
+      bottom.push(fit(`${c.brand(FRAMES[this.frame % FRAMES.length])} ${c.muted(this.#label())}`, cols))
+      if (timer) bottom.push(fit(`  ${c.faint(timer)}`, cols))
     }
     if (this.scroll) bottom.push(c.dim(`  ↓ ${this.scroll} more lines below · scroll down, Shift+↓ or PgDn`))
     if (this.ahead.length) {