Skip to content

CLAUDE.md

Latest commit

 

History

History
114 lines (83 loc) · 4.43 KB

CLAUDE.md

File metadata and controls

114 lines (83 loc) · 4.43 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

This is a LazyVim-based Neovim configuration with extensive customizations for R development, note-taking with Neorg, and general programming. The configuration is built on top of LazyVim's plugin management system and includes specialized configurations for various workflows.

Architecture

  • Entry Point: init.lua bootstraps the configuration by requiring config.lazy
  • Core Configuration: Located in lua/config/
    • lazy.lua: Plugin manager setup and LazyVim configuration
    • options.lua: Vim options and settings
    • keymaps.lua: Custom key mappings
    • autocmds.lua: Auto-commands
  • Plugin Configurations: Individual plugin configs in lua/plugins/
  • LazyVim Extras: Configured via lazyvim.json for language support (Python, JSON, Markdown, YAML, TypeScript)

Key Features & Workflows

R Development

  • Uses R.nvim plugin with radian console integration
  • Custom keymaps: <Enter> sends lines/selections to R console
  • Auto-start R console when R_AUTO_START=true environment variable is set
  • Pipe operator mapping: <localleader>, for magrittr pipes

Note-taking (Neorg)

  • Multiple workspaces configured: work, trading, tech, life, plan
  • Custom keymaps for workspace switching:
    • <leader>wt: trading workspace
    • <leader>ww: work workspace
    • <leader>wj: journal custom
    • <leader>wi: inject metadata
    • <leader>wl: magnify code block

Code Formatting

  • StyLua configuration: 2-space indentation, 120 column width
  • Consistent with Lua configuration standards

Development Environment

  • Terminal: PowerShell on Windows, standard shell on Linux
  • Python host: /usr/bin/python3 (Linux) with hostname-specific paths on Windows
  • Neovide GUI support with font scaling keymaps

Common Commands

Plugin Management

# Update plugins (run from within Neovim)
:Lazy update

# Check plugin status
:Lazy

# Sync parsers for Neorg
:Neorg sync-parsers

R Development

# Start R with auto-start
R_AUTO_START=true nvim file.R

# Within R files:
# <Enter> - Send current line to R console
# <localleader>, - Insert pipe operator (%>%)

Code Formatting

# Format Lua files with StyLua
stylua .

Important Configuration Details

  • Lazy Loading: Most plugins are not lazy-loaded by default (lazy = false)
  • Colorscheme: Tokyo Night with fallback to habamax
  • Completion: Uses nvim-cmp with R completion support
  • Clipboard: System clipboard integration enabled
  • Line Numbers: Relative line numbers enabled
  • Folding: Manual folding enabled
  • Proxy Support: Copilot proxy configuration for specific hostnames

File Structure Notes

  • Plugin configurations are modular - each plugin has its own file in lua/plugins/
  • Custom options override LazyVim defaults in lua/config/options.lua
  • All custom keymaps are centralized in lua/config/keymaps.lua
  • The configuration supports both Linux and Windows environments with conditional settings

Session Notes

2026-01-23: Dashboard 底部深色条带问题

问题: LazyVim 欢迎界面 (snacks_dashboard) 底部显示深色条带

原因: lualine (状态栏) 在 dashboard 上仍然显示。虽然 LazyVim 使用全局状态栏 (laststatus=3)，snacks.dashboard 默认没有完全隐藏它。

解决方案: 创建 lua/plugins/lualine.lua，将 snacks_dashboard 添加到 lualine 的 disabled_filetypes.statusline 列表中，使状态栏在 dashboard 界面不显示。

尝试 1: 仅设置 disabled_filetypes.statusline - 无效，状态栏区域仍显示深色条带

尝试 2: 添加 autocmd，在 snacks_dashboard 文件类型上设置 laststatus = 0 完全隐藏状态栏，离开时恢复 laststatus = 3 - 无效，使用了 vim.opt_local.laststatus 但 laststatus 是全局选项，不支持 local 设置

尝试 3: 将 vim.opt_local.laststatus = 0 改为 vim.opt.laststatus = 0 - 无效，FileType autocmd 触发时机晚于 dashboard 显示

尝试 4: 创建 lua/plugins/snacks.lua，使用 snacks.nvim 的 User 事件 SnacksDashboardOpened 和 SnacksDashboardClosed 来控制 laststatus - 待测试

相关文件:

  • lua/plugins/lualine.lua - 禁用 dashboard 上的状态栏
  • lua/plugins/snacks.lua - 新增，使用 snacks 事件控制状态栏显示
  • lua/config/options.lua - 包含 showtabline = 2 等 UI 设置