?

migrations

Migration: 0.4 → 0.5

Upgrade from rousseau-agent 0.4 to 0.5: transport expansion, TUI streaming, skills, cross-session recall, Signal transport. Config diff and downgrade path.

Overview

0.5 lands the TUI streaming layer, agentskills.io-style skills, FTS5-backed cross-session recall, the Telegram bridge, and (later in the line) the Signal transport. Every change is additive at the config level; existing 0.4 sessions.db files open unchanged.

What changed

  • TUI: streaming responses, spinner, structured status bar (source: internal/tui/). Nothing to configure — behaviour is on by default.
  • Skills: agentskills.io-style Markdown skills discovered from agent.skills_dir. Composed into the system prompt.
  • Cross-session recall: FTS5 index over every session's messages. New tables fts_index created automatically on first open.
  • Transports: Telegram (rousseau telegram) and Signal (rousseau signal) subcommands. Adds telegram.* and signal.* config blocks.
  • Compression: agent.compression.* block introduced. Off by default.

Config diff

provider: claudecli

state:
  path: ~/.local/share/rousseau/sessions.db

agent:
  max_iterations: 32
  approver:
    mode: allow_all

whatsapp:
  reply_header: "*Rousseau*\n\n"

Data-store compatibility

  • 0.4 → 0.5 opens sessions.db in place. On first open under 0.5, additional tables are created via PRAGMA user_version gating.
  • Downgrade to 0.4.x is safe as long as the new tables are ignored (SQLite tolerates extra tables).

Migration steps

# 1. Backup
cp -a ~/.local/share/rousseau ~/.local/share/rousseau.pre-05

# 2. Note current version
rousseau version | tee /tmp/version.pre.txt

# 3. Upgrade
go install github.com/sebastienrousseau/rousseau-agent/cmd/rousseau@v0.5.0
# or use the signed release path from the quickstart

# 4. Verify
rousseau version
rousseau doctor
rousseau session list --limit 5

Downgrade path

# Reinstall the previous minor
go install github.com/sebastienrousseau/rousseau-agent/cmd/rousseau@v0.4.7
rousseau version

Skills discovered on 0.5 remain in ~/.config/rousseau/skills/ — 0.4.x simply ignores them. No data loss.

If the sessions.db was materially edited on 0.5 (e.g. FTS5 rebuilt), restore from backup:

rm ~/.local/share/rousseau/sessions.db*
cp -a ~/.local/share/rousseau.pre-05/. ~/.local/share/rousseau/

Verification checklist

  • rousseau version reports 0.5.x with a stable commit + build date.
  • rousseau doctor — every check is ok or info.
  • rousseau session list shows history unchanged.
  • rousseau session search '<a word from an old chat>' returns hits.
  • rousseau chat streams tokens (spinner turns into text as they arrive).

Related pages

Esc

Type to search 150+ pages. Ranking: BM25 with title/description boost.