fur-cli

Crates.iofur-cli
lib.rsfur-cli
version1.5.0
created_at2025-08-04 21:18:26.555685+00
updated_at2025-12-18 23:19:36.060213+00
descriptionTurn your AI chats into a durable, local-first diary. Save messages, attach notes, organize conversations, and stop losing context every time the model forgets you exist.
homepagehttps://furchats.vercel.app
repositoryhttps://github.com/andrewrgarcia/fur-cli
max_upload_size
id1781199
size230,767
Andrew (andrewrgarcia)

documentation

README

fur logo

FUR

Your AI conversation diary — organized, searchable, and local.
Turn scattered chats into clean, structured, browsable digital diaries.

For an optional visual walkthrough, see the FURChats portfolio site.

FUR: AI Conversation Archiving and Retrieval System

FUR is a command-line system that transforms fragmented AI chats into structured, navigable, and fully searchable local archives.
Designed for researchers, developers, and writers who think with AI and need durable memory, clarity, and fast retrieval.

Why FUR exists

AI chats vanish.
They get buried, lost, unsearchable, and unrecoverable.
FUR turns those conversations into structured knowledge you can return to, reuse, and build on.

Overview

FUR stores every AI conversation in a clean local directory.
Each project (a diary) contains multiple conversations, and each conversation contains timestamped messages, metadata, trees, timelines, and optional Markdown attachments.

Core capabilities:

  • Local, transparent JSON storage
  • Full-project search (fur search)
  • Conversation tagging
  • Timelines and message trees
  • Jot mode and chat import
  • Markdown attachments and export
  • .frs conversation scripting
  • Fast, portable, offline

Installation

From crates.io

cargo install fur-cli

From source

cargo install --path . --force

Project Structure

.fur/
 ├── index.json            # master index
 ├── avatars.json          # persona aliases
 ├── threads/              # per-conversation metadata
 └── messages/             # per-message storage

All files are plain JSON or Markdown.

Core Commands

Create and Write

Command Description
fur new <name> Create a conversation
fur jot "<text>" Add a short message
fur jot "<text>" --file notes.md Add a message with a Markdown attachment
fur chat [avatar] Add long-form content
fur msg Edit or delete a message

Navigate

Command Description
fur convo List conversations
fur convo <id> Switch active conversation
fur timeline Chronological timeline
fur tree Message tree
fur jump <message-id> Jump to a message

Organize

Command Description
fur convo --tag research Add a tag
fur convo --tag "deep learning" Add spaced tag (normalized)
fur convo --clear-tags Remove all tags
fur convo --delete <id> Permanently delete a conversation
fur clone [-i <id>] [--title <name>] Deep-clone a conversation (full copy w/ Markdown)
fur search <query> Full-project search
fur search "deep learning, optimization" Multi-query search

Export

Command Description
fur printed Export current thread to Markdown
fur save Export as .frs script
fur gsearch Scan all FUR journals on disk

Example Workflow

# Create a project
mkdir research && cd research
fur new "GPT-5 Experiments"

# Add short notes
fur jot "Symbolic regression tests using KAN"

# Add longer content
fur chat gpt5

# Attach markdown notes
fur jot "Derivations" --file derivations.md

# Explore
fur convo
fur timeline
fur tree

# Search the entire archive
fur search "memory architecture"
fur search "deep, learning"

# Export
fur printed
fur save session.frs

Search System (v1.0)

FUR’s search engine inspects:

  • Message text
  • Attached Markdown files
  • All conversations across the diary
  • Flexible multi-query syntax
  • Contextual snippet extraction

Examples:

fur search "universal approximator"
fur search "symbolic regression, metadata"
fur search "deep, learning"

Tagging System (v1.0)

Tags are stored at the conversation level:

fur convo --tag research
fur convo --tag "neural forecasting"
fur convo --tag "macro-modeling, metadata-tools"
fur convo --clear-tags

Normalization:

  • lowercase
  • trimmed
  • spaces → hyphens

Example: Input: deep learning Stored as: deep-learning

Philosophy

FUR is not a chat client. It is a durable memory system for people who think and work with AI as part of their intellectual workflow.

Principles:

  • Local ownership
  • Transparent formats
  • Reliability
  • Portability
  • Speed
  • Long-term retrieval

Roadmap

Future enhancements include:

  • Advanced editors for message modification
  • Enhanced search output formats
  • New export templates
  • Optional encrypted diaries
  • Cross-platform installers

License

MIT License

Commit count: 76

cargo fmt