pixtuoid v0.10.0
▸ booting office… ok
▸ loading themes… ok
▸ spawning agents… ok
▸ ready
press any key to skip

Migration

Per-version upgrade notes. Most releases need nothing; the entries below cover the two that changed something user-visible.

v0.7.x → v0.8.0

The pixtuoid install-hooks / uninstall-hooks subcommands were removed. Binding a CLI is now done live in the in-TUI Sources panel: launch pixtuoid, press s, and connect (or disconnect) each agent CLI — its characters appear when you connect and walk out when you disconnect, no restart. pixtuoid run is the only subcommand left (plus validate-pack / init-pack).

If you scripted pixtuoid install-hooks, replace it with the panel — there is no non-interactive equivalent (hooks are installed/removed through the panel toggle). This release also adds two new sources you can connect there: CodeWhale (cw·) and opencode (oc·).

v0.3.x → v0.4.0 (rename: ascii-agentspixtuoid)

v0.4.0 renamed the project from ascii-agents to pixtuoid.

What changed

Before (v0.3.x)After (v0.4.0)
ascii-agents binarypixtuoid
ascii-agents-hook shimpixtuoid-hook
~/.config/ascii-agents/~/.config/pixtuoid/
~/.cache/ascii-agents/~/.cache/pixtuoid/
/tmp/ascii-agents-{uid}.sock/tmp/pixtuoid-{uid}.sock
_ascii_agents hook key in settings.json_pixtuoid

Upgrade steps

  1. Install the new version:

    brew untap IvanWng97/ascii-agents 2>/dev/null
    brew install IvanWng97/pixtuoid/pixtuoid
    # or: cargo install pixtuoid pixtuoid-hook
  2. Re-register hooks: launch pixtuoid, press s to open the Connection panel, and connect your agent CLI (this replaces any old ascii-agents-hook entries automatically). The old pixtuoid install-hooks subcommand is gone — binding a source is now done live inside the TUI.

  3. Migrate config (optional — only if you customized config.toml):

    mkdir -p ~/.config/pixtuoid
    mv ~/.config/ascii-agents/config.toml ~/.config/pixtuoid/config.toml

GitHub links: The old IvanWng97/ascii-agents URL automatically redirects to IvanWng97/pixtuoid. Existing bookmarks and stars carry over.

Source of truth: docs/MIGRATION.md — this page renders it verbatim.