sidekick 0.2.0

Seamless integration between Claude Code and Neovim. Protects your workflow by safely coordinating AI edits with your unsaved work.
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

//! Lua code templates for Neovim buffer operations.

/// Lua code to refresh a buffer while preserving cursor positions across all windows
pub fn refresh_buffer_lua(buf_number: i64) -> String {
    format!(
        r#"
        local buf = {}
        local cursor_positions = {{}}
        local is_current_buf = vim.api.nvim_get_current_buf() == buf

        -- Save cursor positions for all windows displaying this buffer
        for _, win in ipairs(vim.api.nvim_list_wins()) do
            if vim.api.nvim_win_get_buf(win) == buf then
                cursor_positions[win] = vim.api.nvim_win_get_cursor(win)
            end
        end

        -- Refresh the buffer (checktime triggers file change detection)
        vim.api.nvim_buf_call(buf, function()
            vim.cmd('checktime')
            vim.cmd('edit')
        end)

        -- Restore cursor positions
        for win, pos in pairs(cursor_positions) do
            if vim.api.nvim_win_is_valid(win) then
                pcall(vim.api.nvim_win_set_cursor, win, pos)
            end
        end

        -- Force redraw only if this is the current buffer
        if is_current_buf then
            vim.cmd('redraw')
        end
        "#,
        buf_number
    )
}

/// Lua code to send a notification message to Neovim
pub fn send_notification_lua(message: &str) -> String {
    format!(
        r#"vim.notify("{}", vim.log.levels.WARN)"#,
        message.replace('"', r#"\""#)
    )
}

/// Lua code to get visual selection from the current buffer
pub fn get_visual_selection_lua() -> &'static str {
    r#"
    local mode = vim.fn.mode()
    local start_pos, end_pos, sel_type

    if mode:match('[vV\22]') then
        -- Currently in visual mode: use live selection
        start_pos = vim.fn.getpos("v")
        end_pos = vim.fn.getpos(".")
        sel_type = mode:sub(1, 1)
    else
        -- Not in visual mode: use last visual selection marks
        start_pos = vim.fn.getpos("'<")
        end_pos = vim.fn.getpos("'>")
        sel_type = vim.fn.visualmode()
    end

    -- Check if visual marks are set (line numbers > 0)
    if start_pos[2] == 0 or end_pos[2] == 0 then
        return nil
    end

    -- Get current buffer file path
    local file_path = vim.api.nvim_buf_get_name(0)
    if file_path == "" then
        return nil
    end

    -- getregion handles all visual modes (v, V, Ctrl-V) correctly
    local lines = vim.fn.getregion(start_pos, end_pos, { type = sel_type })
    local content = table.concat(lines, "\n")

    -- Get ordered line numbers
    local start_line = math.min(start_pos[2], end_pos[2])
    local end_line = math.max(start_pos[2], end_pos[2])

    return vim.fn.json_encode({
        file_path = file_path,
        start_line = start_line,
        end_line = end_line,
        content = content
    })
    "#
}