lean-ctx 3.5.5

Context Runtime for AI Agents with CCP. 57 MCP tools, 10 read modes, 95+ compression patterns, cross-session memory (CCP), persistent AI knowledge with temporal facts + contradiction detection, multi-agent context sharing + diaries, LITM-aware positioning, AAAK compact format, adaptive compression with Thompson Sampling bandits. Supports 24 AI tools. Reduces LLM token consumption by up to 99%.
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use super::super::{resolve_binary_path, write_file, HookMode, CLI_REDIRECT_RULES, HYBRID_RULES};

pub(crate) fn install_crush_hook() {
    let binary = resolve_binary_path();
    let home = crate::core::home::resolve_home_dir().unwrap_or_default();
    let config_path = home.join(".config/crush/crush.json");
    let display_path = "~/.config/crush/crush.json";

    if let Some(parent) = config_path.parent() {
        let _ = std::fs::create_dir_all(parent);
    }

    let data_dir = crate::core::data_dir::lean_ctx_data_dir()
        .map(|d| d.to_string_lossy().to_string())
        .unwrap_or_default();
    let desired = serde_json::json!({
        "type": "stdio",
        "command": binary,
        "env": { "LEAN_CTX_DATA_DIR": data_dir }
    });

    if config_path.exists() {
        let content = std::fs::read_to_string(&config_path).unwrap_or_default();
        if let Ok(mut json) = crate::core::jsonc::parse_jsonc(&content) {
            if let Some(obj) = json.as_object_mut() {
                let servers = obj.entry("mcp").or_insert_with(|| serde_json::json!({}));
                if let Some(servers_obj) = servers.as_object_mut() {
                    if servers_obj.get("lean-ctx") == Some(&desired) {
                        eprintln!("Crush MCP already configured at {display_path}");
                        return;
                    }
                    servers_obj.insert("lean-ctx".to_string(), desired.clone());
                }
                if let Ok(formatted) = serde_json::to_string_pretty(&json) {
                    let _ = std::fs::write(&config_path, formatted);
                    eprintln!("  \x1b[32m✓\x1b[0m Crush MCP configured at {display_path}");
                    return;
                }
            }
        }
    }

    let content = serde_json::to_string_pretty(&serde_json::json!({
        "mcp": {
            "lean-ctx": desired
        }
    }));

    if let Ok(json_str) = content {
        let _ = std::fs::write(&config_path, json_str);
        eprintln!("  \x1b[32m✓\x1b[0m Crush MCP configured at {display_path}");
    } else {
        tracing::error!("Failed to configure Crush");
    }
}

pub(crate) fn install_crush_hook_with_mode(mode: HookMode) {
    match mode {
        HookMode::CliRedirect => {
            // CLI-first: avoid MCP schema overhead by removing MCP config if present.
            let home = crate::core::home::resolve_home_dir().unwrap_or_default();
            let target = crate::core::editor_registry::EditorTarget {
                name: "Crush",
                agent_key: "crush".to_string(),
                config_path: home.join(".config/crush/crush.json"),
                detect_path: home.join(".config/crush"),
                config_type: crate::core::editor_registry::ConfigType::Crush,
            };
            let _ = crate::core::editor_registry::remove_lean_ctx_server(
                &target,
                crate::core::editor_registry::WriteOptions {
                    overwrite_invalid: true,
                },
            );
            install_crush_cli_redirect_rules(mode);
        }
        HookMode::Hybrid => {
            install_crush_hook();
            install_crush_cli_redirect_rules(mode);
        }
        HookMode::Mcp => {
            install_crush_hook();
        }
    }
}

fn install_crush_cli_redirect_rules(mode: HookMode) {
    let home = crate::core::home::resolve_home_dir().unwrap_or_default();
    let rules_dir = home.join(".config/crush/rules");
    let _ = std::fs::create_dir_all(&rules_dir);
    let rules_path = rules_dir.join("lean-ctx.md");

    let content = match mode {
        HookMode::CliRedirect => CLI_REDIRECT_RULES,
        HookMode::Hybrid => HYBRID_RULES,
        HookMode::Mcp => return,
    };

    write_file(&rules_path, content);

    let mode_name = match mode {
        HookMode::CliRedirect => "cli-redirect",
        HookMode::Hybrid => "hybrid",
        HookMode::Mcp => "mcp",
    };
    eprintln!(
        "  \x1b[32m✓\x1b[0m Crush rules installed in {mode_name} mode at {}",
        rules_path.display()
    );
}