fur-cli 2.1.1

Turn 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.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

mod core;

pub use core::upgrade_message_schema;

use self::core::*;
use clap::Parser;
use serde_json::Value;

#[derive(Parser, Debug)]
pub struct JotArgs {
    /// Optional avatar name (defaults to 'main' if omitted)
    #[arg(index = 1)]
    pub avatar: Option<String>,

    /// Optional jot text
    #[arg(index = 2)]
    pub positional_text: Option<String>,

    /// Jot text (takes precedence over positional)
    #[arg(long)]
    pub text: Option<String>,

    /// Attach markdown file
    #[arg(long, alias = "file")]
    pub markdown: Option<String>,

    /// Attach image (PNG, JPG, etc.)
    #[arg(long)]
    pub img: Option<String>,

    /// Parent message ID (optional, for replies)
    #[arg(long)]
    pub parent: Option<String>,
}

pub fn run_jot(args: JotArgs) {
    let ctx = match load_context() {
        Ok(c) => c,
        Err(e) => return eprintln!("{}", e),
    };

    let (avatar, text_opt) = resolve_avatar_and_text(&ctx.avatars, &args);

    if let Err(e) = validate_inputs(&text_opt, &args.markdown) {
        return eprintln!("{}", e);
    }

    // Bring the attachment into the conversation folder before recording its
    // path, so the archive stays self-contained.
    let markdown = args.markdown.as_deref().map(adopt_markdown);

    let msg = build_message(
        &avatar,
        text_opt.clone(),
        markdown,
        args.img.clone(),
        args.parent.clone(),
    );
    let msg_id = msg["id"].as_str().unwrap().to_string();

    apply_jot_effects(&ctx, &msg, &msg_id, args.parent.as_deref(), &avatar);
}

pub fn apply_jot_effects(
    ctx: &FurContext,
    msg: &Value,
    msg_id: &str,
    parent: Option<&str>,
    avatar: &str,
) {
    save_message(&ctx.fur_dir, msg_id, msg);
    update_conversation(ctx, msg_id, parent);
    update_index(&ctx.fur_dir, msg_id);
    print_confirmation(&ctx.avatars, avatar, msg_id, &ctx.conversation_id);

    // viceroy: dual-write — .fur/ is written above and stays authoritative;
    // chats/<slug>/convo.md is regenerated from it so the two cannot drift.
    crate::schema::bridge::sync_active();
}