chopsticks/CHANGELOG.md
m1ngsama 23ad2e5b7a feat: ergonomics overhaul, tmux integration, and beginner onboarding (v1.1.0)
Keybindings:
- Add jk → Esc in insert mode (ergonomic escape)
- Add Ctrl+s save in normal and insert mode
- Add // visual search (very-nomagic escaped)
- Add <leader>p/P clipboard paste
- Add <leader>rG ripgrep word under cursor (-F literal)
- Add <leader>u / <leader>tt as leader aliases for F5/F8
- Fix ALE [e/]e navigation direction (was reversed)
- Remove dead <C-h/j/k/l> maps (owned by vim-tmux-navigator)
- Remove <leader>pp (duplicate of F2, caused 500ms delay on <leader>p)

Plugins:
- Add vim-tmux-navigator for seamless Vim/tmux pane navigation
- Fix <leader>rG: pass -F so regex metacharacters don't corrupt matches
- Fix LargeFileSettings: disable ALE for files >10MB

In-Vim UX:
- Add ,? cheat sheet (read-only buffer, q to close)
- ALE lint triggers: normal/enter/insert-leave now active

install.sh:
- Add tmux.conf auto-configuration step with C-l warning
- Add post-install survival guide for first-time Vim users

Docs:
- README: full badge row (release, stars, issues, last-commit, PRs, plugins, languages)
- README: Contributing section with bug/PR guidelines
- QUICKSTART: Step 0 — Vim modes and 4 survival commands for beginners
- CHANGELOG: v1.1.0 entry
2026-04-09 12:20:10 +08:00

6.6 KiB

Changelog

All notable changes to chopsticks are documented here.


[1.1.0] - 2026-04-09

Ergonomics and automation overhaul: community-standard keybindings, seamless tmux integration, an in-Vim cheat sheet, a beginner onboarding section, and several correctness fixes from a systematic review.

Added

  • jkEsc in insert mode — ergonomic escape without reaching for the key
  • Ctrl+s save in normal and insert mode (add stty -ixon to shell rc to enable in terminals that use XON/XOFF flow control)
  • // visual search — search for visually selected text using \V very-nomagic escaping
  • <leader>p / <leader>P — paste from system clipboard after/before cursor
  • <leader>rG — ripgrep word under cursor with -F (literal, not regex)
  • <leader>u — leader-key alias for UndoTree (complements F5)
  • <leader>tt — leader-key alias for Tagbar (complements F8)
  • ,? in-Vim cheat sheet — opens a read-only buffer covering modes, survival commands, search, code intelligence, git, and clipboard; press q to close
  • vim-tmux-navigator plugin — Ctrl+h/j/k/l navigates seamlessly across Vim splits and tmux panes without a prefix key
  • install.sh tmux step — detects tmux and optionally appends the four navigator bind-key lines to ~/.tmux.conf; warns about C-l/screen-clear tradeoff
  • install.sh survival guide — post-install output now shows the 4 essential commands for first-time Vim users, plus the stty -ixon advisory
  • QUICKSTART.md Step 0 — new first section explaining Vim modes (Normal/Insert/Visual) and 4 survival commands; makes the guide usable by users who have never opened Vim
  • let b:ale_enabled = 0 in LargeFileSettings() — ALE no longer spawns linter subprocesses for files over 10 MB

Changed

  • ALE lint triggersale_lint_on_text_changed changed from 'never' to 'normal'; ale_lint_on_insert_leave and ale_lint_on_enter changed from 0 to 1 — diagnostics now refresh on buffer enter and after edits settle in normal mode
  • <C-h/j/k/l> manual maps removed — vim-tmux-navigator owns these keys at plugin load time; the previous hand-rolled <C-W> maps were unreachable dead code
  • <leader>pp paste-mode toggle removed — functionally identical to the existing F2 pastetoggle; its presence caused a 500 ms delay on every <leader>p paste

Fixed

  • ALE navigation direction reversed[e now correctly calls ALEPrevious and ]e calls ALENext, matching the vim-unimpaired [/] convention
  • <leader>rG regex metacharacter bug — without -F, characters like . * ( in the cursor word were treated as regex, producing incorrect matches

[1.0.0] - 2026-03-29

First stable release. Full-stack engineering environment out of the box — automatic installation, tiered LSP, TTY fallback, and coverage for 14 languages.

Added

  • Arch Linux support in install.sh — pacman branch for all system tools
  • hadolint added to system tools installation (Dockerfile linting)
  • staticcheck added to Go tools (replaces archived golint)
  • yamllint added to pip tools (YAML linting)
  • coc-settings.json — configures marksman as Markdown LSP for CoC via languageserver entry; symlinked automatically by install.sh
  • pip3 bootstrap in install.sh — auto-installs pip3 when python3 is present but pip3 is absent (common on Ubuntu minimal images)
  • 9 named augroups in .vimrc — all loose autocmd statements now wrapped with autocmd! to prevent doubling on :source $MYVIMRC: ChopstickTabHistory, ChopstickResize, ChopstickStdin, CocHighlight, ChopstickCleanup, ChopstickFiletype, ChopstickTTYLargeFile, ChopstickWhichKey, ChopstickStartify
  • TTY-safe plugin installvim +PlugInstall +qall </dev/null prevents Vim from blocking in non-interactive/piped environments

Changed

  • SQL tooling unified to sqlfluff (pip) — sqlfmt removed from npm section
  • Go linter changed from golint (archived 2023) to staticcheck
  • Markdown LSP changed from broken coc-marksman (npm) to marksman binary configured via coc-settings.json

Fixed

  • vim-go startup hang on Arch Linux — removed :GoUpdateBinaries post-install hook; set g:go_gopls_enabled = 0 to prevent conflict with coc-go
  • E495 errors (<afile> in special buffers) — all <afile> usages guarded with !empty(expand('<afile>')) and empty(&buftype) checks
  • g:go_def_mode conflict — now conditional: uses gopls when CoC active, godef when vim-lsp active (avoids error when gopls is disabled)
  • vim startup UX — NERDTree + Startify layout for vim . and bare vim
  • coc-marksman silent failure — package does not exist on npm; replaced with native languageserver configuration in coc-settings.json
  • CoC startup warning in no-node environments — g:coc_start_at_startup = 0 and g:coc_disable_startup_warning = 1 set when g:use_coc = 0

[0.9.0] - 2026-02-21

Added

  • Full-stack language coverage — LSP, lint, and format for: Python, JavaScript, TypeScript, Go, Rust, Shell, YAML, HTML, CSS/SCSS, Less, JSON, Markdown, SQL, Dockerfile
  • install.sh overhaul — automated installation of system tools, npm tools, pip tools, Go tools, and CoC language server extensions with platform detection and interactive prompts; --yes flag for non-interactive mode
  • vim-startify startup screen with dynamic header (version, cwd, git branch)
  • vim-which-key keybinding popup on , + 500ms pause
  • Startup layoutvim . opens NERDTree left + Startify right; bare vim opens Startify with NERDTree alongside
  • Session management via vim-obsession + vim-prosession
  • Large file handling — syntax and undo disabled for files > 10 MB
  • Project-local config.vimrc in project root auto-loaded via set exrc
  • Persistent undo~/.vim/.undo/ with undolevels=1000

Changed

  • Tiered LSP backend: CoC (Node.js) preferred, vim-lsp (no Node.js) as fallback
  • All CoC and vim-lsp keybindings unified (gd, K, [g/]g, ,rn, ,ca)
  • ALE fix_on_save disabled when vim-lsp active (prevents double-format)
  • NERDTree autocmd wrapped in augroup NERDTreeAutoClose

Fixed

  • Multiple leader key conflicts resolved (,ad, ,cd, ,cp, ,sp, ,t)
  • CtrlP removed (redundant with FZF)
  • Duplicate set options cleaned up
  • <leader>A dead mapping (no alternate-file plugin) removed

[0.1.0] - 2024

Initial release — base Vim configuration with vim-plug, basic plugins, and TTY/non-TTY detection.