fur-cli 0.4.3

FUR — a forkable, unearthable, recursive memory tracker for your local chat logs
Documentation

🤔 What is FUR?

FUR is a lightweight tool that helps you organize your AI chats into diaries, with each diary holding multiple conversations you can revisit, navigate, and export.

Instead of endless scrolling through chat history, FUR gives you:

✅ multiple diaries
✅ each diary containing its own conversations
✅ every conversation cleanly structured
✅ easy navigation, timelines, and exports
✅ memory you can actually use later

Think of it as your AI companion's journal, stored locally, under your control.

No cloud.
No syncing.
No mystery.

Just clean conversation tracking, built for people who think with AI.

🌟 What can FUR do?

Write

  • Jot quick notes
  • Chat long-form messages or paste documents
  • Attach Markdown files
  • Save conversations as portable .frs scripts

Organize

  • Create a new conversation (fur new)
  • Assign avatars/personas
  • Jump to any message
  • View conversations as timelines or trees
  • Switch quickly between conversations

Export

  • Save conversations as Markdown
  • Generate PDF timelines
  • Script entire conversations using .frs

Optional Git enhancements

If your FUR project lives inside a Git repo, you also get:

  • fur status showing Git status
  • passthrough commands (fur add, fur commit, etc.)

...but Git is never required.
FUR works perfectly without it.

🛠 How it works

FUR stores everything inside a small local folder:

  • .fur/index.json → list of conversations
  • .fur/threads/*.json → one file per conversation diary
  • .fur/messages/*.json → messages inside each conversation diary
  • .fur/avatars.json → your persona mapping

Everything is human-readable, portable, and version-safe.

📘 Example workflow

# Create a new AI conversation
fur new "My GPT-5 Notes"

# Add quick jot
fur jot "Deep learning troubleshooting ideas"

# Paste long chats
fur chat gpt5

# Quick jot with attached document
fur jot "These notes are tied to what I learned in DSA" --file notes/DSA.md

# See all conversations in your diary (.fur project)
fur convo
# Switch to another conversation
fur convo <conversation_id (first unique characters)>

# Export your currently-tracked conversation to Markdown
fur printed 

# Global scan for all diaries in your computer (very fast)
fur gsearch 

# Optional: Git passthrough (if repo exists)
fur add .
fur commit -m "Updated conversations"
fur push

🚀 Installation

From crates.io

cargo install fur-cli

From source

cargo install --path . --force

🐾 Philosophy

FUR isn't trying to be an AI client or a chat interface.

It's something simpler:

A place to keep your conversations with clarity.

Your chats with AI, with yourself, and with collaborators deserve a clear place to live. FUR gives them that home.

Fast. Local. Searchable. Yours.

🛣 Roadmap to v1.0

✅ Already complete

  • Multiple diaries (.fur projects) & conversations
  • Avatars / personas
  • Timelines & trees
  • Jot & chat modes
  • Jump navigation
  • .frs scripting
  • Markdown & PDF exports
  • Optional Git passthrough

🔜 Planned

  • Message deletion & editing
  • Diary-level tagging
  • Richer export layouts
  • Search improvements
  • Optional helper for Git ignore rules
  • Cross-platform installers

📜 License

MIT, like almost everything else that's friendly and open-source.