xonecas.io
56101
Df

dotfiles / commit 985ba0a

docs: update README files for nvim-tree, fugitive, and bufferline changes

Sean2026-01-30 985ba0a5665b266005d60b6cf53fb3ad6b217bd2 parent 4f6622b

3 files changed

README.md+7−5
@@ -12,18 +12,19 @@ This repository contains my personal configuration files (dotfiles) for various
1212
1313 Location: `nvim/`
1414
15-Modern Neovim setup using Lua and lazy.nvim plugin manager with LSP support, git integration, and a buffer-based file explorer.
15+Modern Neovim setup using Lua and lazy.nvim plugin manager with LSP support, git integration, and a tree-based file explorer.
1616
1717 - **init.lua** - Main configuration file with basic settings and keybindings
18-- **lua/plugins/** - Plugin configurations (oil, LSP with Mason, gitsigns, diffview, lualine, comment)
18+- **lua/plugins/** - Plugin configurations (nvim-tree, bufferline, LSP with Mason, gitsigns, fugitive, lualine, comment)
1919 - **colors/ansi.vim** - Terminal-respecting 16-color ANSI colorscheme
2020 - **README.md** - Detailed Neovim setup documentation
2121
2222 **Key Features:**
2323 - Leader key: Space
24-- Buffer-centric workflow with oil.nvim
24+- Tree-based file explorer with nvim-tree
25+- Buffer tabs with bufferline
2526 - LSP support with Mason installer
26-- Git integration (gitsigns + diffview)
27+- Git integration (gitsigns + fugitive)
2728 - Minimal, focused configuration
2829
2930 ### OpenCode Configuration
@@ -33,7 +34,8 @@ Location: `opencode/`
3334 Configuration for the OpenCode AI coding assistant with custom behaviors, commands, and reusable skills.
3435
3536 - **AGENTS.md** - Core agent behavior and debugging principles
36-- **commands/** - Custom slash commands (commit-all, format-then-lint)
37+- **agents/** - Custom agents (debug, plan)
38+- **commands/** - Custom slash commands (commit-all, format-then-lint, review)
3739 - **skills/** - Reusable skills (good-programming-principles, token-efficiency-opencode)
3840
3941 **Key Principles:**
nvim/README.md+23−16
@@ -9,9 +9,10 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
99 ├── init.lua # Main configuration file
1010 ├── lua/
1111 │ └── plugins/ # Plugin configurations
12-│ ├── oil.lua # File explorer
12+│ ├── nvim-tree.lua # File explorer
13+│ ├── bufferline.lua # Buffer tabs
14+│ ├── fugitive.lua # Git commands
1315 │ ├── lsp.lua # LSP configuration with Mason
14-│ ├── diffview.lua # Git diff viewer
1516 │ ├── gitsigns.lua # Git decorations
1617 │ ├── comment.lua # Comment toggling
1718 │ └── lualine.lua # Statusline
@@ -23,7 +24,10 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
2324 ## Plugins
2425
2526 ### File Management
26-- **oil.nvim** - Edit your filesystem like a buffer. Press `-` or `<Space>n` to open.
27+- **nvim-tree.lua** - Tree-based file explorer. Press `<leader>e` to toggle.
28+
29+### Buffer Tabs
30+- **bufferline.nvim** - VSCode-style buffer tabs with mouse support.
2731
2832 ### Language Server Protocol (LSP)
2933 - **nvim-lspconfig** - LSP client configuration for Neovim
@@ -31,7 +35,7 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
3135 - **mason-lspconfig.nvim** - Bridge between mason.nvim and nvim-lspconfig
3236
3337 ### Git Integration
34-- **diffview.nvim** - Review git changes, commits, and file history with ease.
38+- **vim-fugitive** - Git commands inside Neovim (`:Git`, `:Git diff`).
3539 - **gitsigns.nvim** - Inline git decorations showing added/changed/deleted lines in the sign column.
3640
3741 ### Editing
@@ -60,9 +64,9 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
6064 ```
6165
6266 5. Try the file explorer:
63- ```
64- Press <Space>n or -
65- ```
67+ ```
68+ Press <leader>e
69+ ```
6670
6771 6. Try commenting:
6872 ```
@@ -71,17 +75,19 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
7175 ```
7276
7377 7. Try git integration (in a git repo):
74- ```
75- Press <Space>dv (open diffview)
76- Press ]c (next git change)
77- ```
78+ ```
79+ Press <leader>d (git diff via fugitive)
80+ Press ]c (next git change)
81+ Press [c (previous git change)
82+ ```
7883
7984 ## Key Features
8085
8186 - **Leader key**: `Space`
8287 - **LSP support**: Language server protocol with Mason package manager for easy server installation
83-- **File explorer**: Buffer-based with oil.nvim (edit filesystem like text)
84-- **Git diff viewer**: Comprehensive diff interface with diffview.nvim
88+- **File explorer**: Tree-based with nvim-tree (`<leader>e`)
89+- **Buffer tabs**: Visual buffer list with bufferline.nvim
90+- **Git commands**: Fugitive for `:Git` workflow and quick diffs
8591 - **Git decorations**: Inline change markers with gitsigns.nvim
8692 - **Terminal colors**: Uses the `ansi` colorscheme and 16-color theme for lualine, respecting your terminal's color palette
8793 - **Clean config**: Only essential options, modern Lua syntax
@@ -91,7 +97,7 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
9197
9298 - Minimal and focused - only includes what's needed
9399 - Modern Neovim defaults - removes redundant settings
94-- Buffer-centric workflow - oil.nvim instead of traditional tree explorer
100+- Tree-based navigation - nvim-tree with bufferline tabs
95101 - Git-first - excellent git integration out of the box
96102
97103 ## Customization
@@ -105,8 +111,9 @@ Modern Neovim configuration using Lua and lazy.nvim plugin manager.
105111 - [lazy.nvim docs](https://github.com/folke/lazy.nvim)
106112 - [nvim-lspconfig docs](https://github.com/neovim/nvim-lspconfig)
107113 - [mason.nvim docs](https://github.com/williamboman/mason.nvim)
108-- [oil.nvim docs](https://github.com/stevearc/oil.nvim)
109-- [diffview.nvim docs](https://github.com/sindrets/diffview.nvim)
114+- [nvim-tree docs](https://github.com/nvim-tree/nvim-tree.lua)
115+- [bufferline.nvim docs](https://github.com/akinsho/bufferline.nvim)
116+- [vim-fugitive docs](https://github.com/tpope/vim-fugitive)
110117 - [gitsigns.nvim docs](https://github.com/lewis6991/gitsigns.nvim)
111118 - [Comment.nvim docs](https://github.com/numToStr/Comment.nvim)
112119 - [lualine.nvim docs](https://github.com/nvim-lualine/lualine.nvim)
opencode/README.md+4−4
@@ -5,7 +5,7 @@ Personal OpenCode configuration with custom agents, slash commands, and skills.
55 ## Structure
66
77 - **`AGENTS.md`** — Global agent instructions (communication style, debugging principles, efficiency rules)
8-- **`agents/`** — Custom agent definitions (debug, thinker)
8+- **`agents/`** — Custom agent definitions (debug, plan)
99 - **`commands/`** — Slash commands (commit-all, format-then-lint, review)
1010 - **`skills/`** — Custom skills (good-programming-principles, token-efficiency-opencode)
1111 - **`install.sh`** — Symlink installer for `~/.config/opencode`
@@ -18,11 +18,11 @@ Personal OpenCode configuration with custom agents, slash commands, and skills.
1818
1919 Read-only during investigation; implements fixes only after completing the four-phase debugging process. No shortcuts permitted.
2020
21-### Thinker
21+### Plan
2222 **Mode:** Primary
23-**Purpose:** Creative brainstorming and design thinking
23+**Purpose:** Read-only planning and design
2424
25-Read-only agent for exploring ideas, proposing alternatives, and shaping designs before implementation. Asks questions one at a time.
25+Read-only agent for scoping work, comparing approaches, and writing plans to `.opencode/plans` before implementation.
2626
2727 ## Commands