Skip to content

v1.3.0 — External Deep Clone Traveling ✈️

Choose a tag to compare

View all tags
@andrewrgarcia andrewrgarcia released this 08 Dec 23:57
· 33 commits to main since this release
v1.3.0
cce4129

v1.3.0 — External Deep Clone Traveling ✈️

This release introduces the biggest structural capability FUR has gained since inception:
you can now deep-clone a full conversation — with all messages, metadata, branches, parents, timestamps, and Markdown attachments — into any other FUR project on your filesystem.

This makes FUR a true multi-project knowledge system.

🚀 New: xclone — External Deep Clone Command

You can now export a conversation from one .fur project into another:

fur xclone --to ../target-project

Or specify a conversation explicitly:

fur xclone --to ../target-project -i 8b

Use a custom title:

fur xclone --to ../target-project -i 73 --title "Backup of Judo Chapter"

What xclone does (fully automated):

  • Copies thread metadata into target/.fur/threads/
  • Copies all message JSONs into target/.fur/messages/
  • Properly rewrites all message IDs using a new UUID map
  • Properly remaps parents, children, and branches
  • Copies all Markdown attachments into target/chats/
  • Preserves Markdown relative paths (e.g. chats/xxx.md)
  • Auto-creates target/.fur/ + target/chats/ if missing
  • Updates target/.fur/index.json and sets the new conversation active
  • Guarantees a perfect deep structural clone, identical to the original

This unlocks:

  • Project-to-project story migration
  • Backups and snapshots
  • Exporting a conversation into a book folder
  • Sharing FUR conversation trees across repositories

🧭 Improved: Smart Truncated Conversation View

fur convo now defaults to a windowed, truncated table that always shows:

  • The active conversation (highlighted)
  • A few neighbors above and below
  • Ellipses (...) when rows are omitted

Example:

...
3ea36309   Chapter 7
b1e8f5ab   Chapter 14
8b7bfde7   How to Protect My Voice   <— active
7597d06d   Chapter 8
1c95673f   Chapter 2
...

This prevents massive scrolling in large projects.

Show full view with:

fur convo --all

🧩 Other Improvements

  • Internal refactors to prepare for cross-project operations
  • More robust detection and creation of .fur/ structure
  • Markdown clone suffix logic preserved (c, cc, ccc, etc.)
  • More stable rendering of conversation tables

🏁 Summary

FUR v1.3.0 is a substantial usability upgrade so far:

  • xclone brings multi-project workflows
  • Smarter conversation browsing improves daily use
  • Better file structure handling opens the door to future import/export features (e.g., xpull, selective clone, tagging-based batch export)

Your memory system is no longer limited to a single directory.
It now travels.

Assets 2
Loading