recall 0.3.0

Sync Claude Code's auto memory across machines and cloud sessions
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
80
81
82
83
84
85

//! `recall init` — opt one project in.

use std::path::Path;

use recall_hooks::{exit, settings};

use crate::project;

/// Wires `.claude/settings.json`, then says what is still missing.
///
/// This is loud where the rest of the CLI is quiet: it edits a file the user
/// is expected to read and commit, so it refuses to guess at a location, and
/// it reports incomplete configuration rather than pretending sync is
/// working.
pub fn run(path: Option<&Path>) -> anyhow::Result<i32> {
    let root = match path {
        Some(p) => p.to_path_buf(),
        None => match project::git_root() {
            Some(root) => root,
            None => anyhow::bail!(
                "not inside a git repository — run this from the project you want to sync"
            ),
        },
    };
    let settings_path = root.join(".claude").join("settings.json");

    if settings::wire_file(&settings_path)? {
        println!("recall: wired hooks into {}", settings_path.display());
        print_commit_hint(&root);
    } else {
        println!(
            "recall: already wired, nothing to change ({})",
            settings_path.display()
        );
    }

    warn_about_unset_variables(&root);
    Ok(exit::OK)
}

/// Committing the change is not a nicety — it is what makes a fresh clone or
/// a cloud session pick sync up without per-machine setup.
fn print_commit_hint(root: &Path) {
    println!(
        "
  Next: review and commit the change, so fresh clones and cloud sessions
  pick it up too — that's what makes this work without per-machine setup.

    git -C {0} diff .claude/settings.json
    git -C {0} add .claude/settings.json && git -C {0} commit -m \"Enable Recall memory sync\"",
        root.display()
    );
}

/// Reports what is still missing, reading the environment the *hooks* will
/// run under rather than this shell's.
///
/// The difference is not academic: a project that declares these in the
/// `.claude/settings.json` this command just wired is fully configured, and
/// warning about them there would send someone editing a shell profile to
/// fix something that is not broken.
fn warn_about_unset_variables(root: &Path) {
    let cfg = project::resolve_at(root.to_path_buf()).config();
    if !cfg.url.is_empty() && !cfg.token.is_empty() {
        return;
    }

    println!();
    if cfg.url.is_empty() {
        println!("  ! RECALL_URL is not set — not in this shell, nor in any settings file");
    }
    if cfg.token.is_empty() {
        println!("  ! RECALL_TOKEN is not set — not in this shell, nor in any settings file");
    }
    println!(
        "
  Add these to your shell profile (~/.zshrc, ~/.bashrc) before sync works:

    export RECALL_URL=\"https://your-recall-host\"
    export RECALL_TOKEN=\"<your token>\"

  See docs/reference/token-setup.md for generating the token, and for the extra
  variables a claude.ai cloud environment needs."
    );
}