reflex-search 1.0.3

A local-first, structure-aware code search engine for AI agents
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
111
112
113
114
115
116
117
118
119
120
121

use std::env;

/// Terminal capabilities and feature detection
#[derive(Debug, Clone)]
pub struct TerminalCapabilities {
    /// Whether the terminal supports OSC 8 hyperlinks
    pub supports_hyperlinks: bool,
    /// Terminal type identifier
    pub terminal_type: TerminalType,
    /// Whether mouse events are supported
    pub supports_mouse: bool,
}

#[derive(Debug, Clone, PartialEq)]
pub enum TerminalType {
    ITerm2,
    WezTerm,
    Kitty,
    VSCode,
    Alacritty,
    Tmux,
    Screen,
    Unknown,
}

impl TerminalCapabilities {
    /// Detect terminal capabilities from environment variables
    pub fn detect() -> Self {
        let terminal_type = Self::detect_terminal_type();
        let supports_hyperlinks = Self::detect_hyperlink_support(&terminal_type);
        let supports_mouse = true; // Most modern terminals support mouse events

        Self {
            supports_hyperlinks,
            terminal_type,
            supports_mouse,
        }
    }

    fn detect_terminal_type() -> TerminalType {
        // Check TERM_PROGRAM first (most specific)
        if let Ok(term_program) = env::var("TERM_PROGRAM") {
            return match term_program.as_str() {
                "iTerm.app" => TerminalType::ITerm2,
                "WezTerm" => TerminalType::WezTerm,
                "vscode" => TerminalType::VSCode,
                _ => Self::detect_from_term_var(),
            };
        }

        Self::detect_from_term_var()
    }

    fn detect_from_term_var() -> TerminalType {
        if let Ok(term) = env::var("TERM") {
            if term.contains("kitty") {
                return TerminalType::Kitty;
            } else if term.contains("alacritty") {
                return TerminalType::Alacritty;
            } else if term.contains("tmux") {
                return TerminalType::Tmux;
            } else if term.contains("screen") {
                return TerminalType::Screen;
            }
        }

        TerminalType::Unknown
    }

    fn detect_hyperlink_support(terminal_type: &TerminalType) -> bool {
        matches!(
            terminal_type,
            TerminalType::ITerm2
                | TerminalType::WezTerm
                | TerminalType::Kitty
                | TerminalType::VSCode
        )
    }

    /// Generate an OSC 8 hyperlink for a file path
    pub fn make_hyperlink(&self, path: &str, line: usize, display_text: &str) -> String {
        if !self.supports_hyperlinks {
            return display_text.to_string();
        }

        let url = format!("file://{path}:{line}");
        format!("\x1b]8;;{url}\x1b\\{display_text}\x1b]8;;\x1b\\")
    }

    /// Get the appropriate hint text for opening files
    pub fn open_hint(&self) -> &'static str {
        if self.supports_hyperlinks {
            "[Cmd+Click to open]"
        } else {
            "[Press 'o' to open]"
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_capabilities_detection() {
        let caps = TerminalCapabilities::detect();
        assert!(caps.supports_mouse);
    }

    #[test]
    fn test_hyperlink_generation() {
        let caps = TerminalCapabilities {
            supports_hyperlinks: true,
            terminal_type: TerminalType::Kitty,
            supports_mouse: true,
        };

        let link = caps.make_hyperlink("/path/to/file.rs", 42, "file.rs:42");
        assert!(link.contains("file:///path/to/file.rs:42"));
    }
}