Skip to content

naranyala/agentic-nvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌟 Pure mini.nvim Configuration

A 100% mini.nvim-based Neovim configuration using mini.deps for plugin management. No lazy.nvim, no external plugin managers - just pure mini.nvim!

✨ Quick Start

# Clone and install
git clone https://github.com/yourusername/naranyala-agentic-nvim ~/.config/nvim
cd ~/.config/nvim
./install.sh

# Switch profile
./profile.sh switch system  # For C/Rust/Go
./profile.sh switch web     # For JS/TS/CSS
./profile.sh switch minimal # For quick edits

πŸ“š Documentation

Complete documentation in the docs/ directory:

# Document Description
01 Introduction Welcome & overview
02 Installation Install & setup guide
03 Profiles Profile system guide
04 Plugins All plugins documented
05 Keybindings Keyboard shortcuts
06 mini.deps Plugin management
07 Troubleshooting Common issues

🎭 Available Profiles

Profile Description Best For
default Full mini.nvim setup Daily driving
minimal Core editing only Quick edits, servers
full Everything + LSP Full development
lazy Pure Neovim Ultra-fast startup
system C/C++/Rust/Go Systems programming
web JS/TS/CSS/HTML Web development

⚑ Features

Plugin Management

  • βœ… mini.deps - Built-in plugin manager
  • βœ… No external dependencies
  • βœ… Automatic dependency resolution
  • βœ… Local plugin support

Profile System

  • βœ… Switch configurations instantly
  • βœ… Profile-specific plugins
  • βœ… Environment variable support
  • βœ… Fuzzy search picker (<leader>pp)

mini.nvim Modules (25+)

  • βœ… mini.ai - Text objects
  • βœ… mini.comment - Toggle comments
  • βœ… mini.surround - Surround operations
  • βœ… mini.pick - Fuzzy finder
  • βœ… mini.files - File explorer
  • βœ… mini.diff - Git diff
  • βœ… mini.statusline - Status line
  • βœ… mini.hues - Colorschemes
  • βœ… And 17+ more!

Development Features (Full/System/Web)

  • βœ… LSP - Language server support
  • βœ… Treesitter - Syntax highlighting
  • βœ… nvim-cmp - Autocompletion (web)
  • βœ… Git integration - Gitsigns, blame
  • βœ… Which-key - Keybinding hints

πŸš€ Installation

Prerequisites

  • Neovim 0.10+
  • Git
  • Nerd Font (recommended)

Quick Install

cd /path/to/naranyala-agentic-nvim
./install.sh

The installer will:

  1. Backup your current config
  2. Create symlink to new config
  3. Install mini.nvim automatically

See full installation guide β†’


🎯 Profile Management

Command Line

# List profiles
./profile.sh list

# Switch profile
./profile.sh switch system

# Create custom profile
./profile.sh create my-dev

In Neovim

-- Open profile picker (fuzzy search)
<leader>pp

-- Show current profile
<leader>pc

-- Or use command
:ProfilePicker

See profiles documentation β†’


⌨️ Key Bindings

Leader Key

  • Normal mode: <Space>
  • Visual mode: \

Essential Keys

Key Action
<leader>e Open file explorer
<leader>f Find files
<leader>g Grep search
<leader>pp Profile picker
gcc Toggle comment
gsa Add surround
[d / ]d Previous/Next diagnostic
gd Go to definition

See all keybindings β†’


πŸ“¦ Plugin Management

Using mini.deps

-- Add plugin
:lua MiniDeps.add({ source = "author/plugin.nvim" })

-- Update all
:lua MiniDeps.update()

-- Sync plugins
:lua MiniDeps.sync()

-- List installed
:lua MiniDeps.summary()

See mini.deps guide β†’


🎨 Colorschemes

Built-in via mini.hues:

:colorscheme minicyan      " Default
:colorscheme miniwinter    " Winter theme
:colorscheme minispring    " Spring theme
:colorscheme minisummer    " Summer theme
:colorscheme miniautumn    " Autumn theme

πŸ› Troubleshooting

Common Issues

mini.nvim not installing:

git clone --filter=blob:none --branch stable \
  https://github.com/echasnovski/mini.nvim \
  ~/.local/share/nvim/site/pack/deps/start/mini.nvim

Plugins not loading:

:lua MiniDeps.sync()
:checkhealth

Profile not loading:

./profile.sh current
./profile.sh switch default

See troubleshooting guide β†’


πŸ“ Project Structure

naranyala-agentic-nvim/
β”œβ”€β”€ init.lua                    # Entry point
β”œβ”€β”€ profile.sh                  # Profile switcher
β”œβ”€β”€ install.sh                  # Installer
β”œβ”€β”€ restore.sh                  # Restore script
β”œβ”€β”€ README.md                   # This file
β”œβ”€β”€ docs/                       # Documentation (flat structure)
β”‚   β”œβ”€β”€ 01-introduction.md
β”‚   β”œβ”€β”€ 02-installation.md
β”‚   β”œβ”€β”€ 03-profiles.md
β”‚   β”œβ”€β”€ 04-plugins.md
β”‚   β”œβ”€β”€ 05-keybindings.md
β”‚   β”œβ”€β”€ 06-mini-deps.md
β”‚   └── 07-troubleshooting.md
β”œβ”€β”€ scripts/
β”‚   └── profile-switcher.sh     # Profile CLI
└── lua/
    β”œβ”€β”€ config/                 # Base config
    β”‚   β”œβ”€β”€ loader.lua          # Profile loader
    β”‚   β”œβ”€β”€ options.lua         # Options
    β”‚   β”œβ”€β”€ keymaps.lua         # Keymaps
    β”‚   └── autocmds.lua        # Autocmds
    β”œβ”€β”€ plugins/                # Plugin configs
    β”‚   β”œβ”€β”€ mini-*.lua          # mini.nvim modules
    β”‚   β”œβ”€β”€ lsp.lua             # LSP config
    β”‚   β”œβ”€β”€ treesitter.lua      # Treesitter
    β”‚   └── local/              # Local plugins
    └── profiles/               # Profile configs
        β”œβ”€β”€ default/
        β”œβ”€β”€ minimal/
        β”œβ”€β”€ full/
        β”œβ”€β”€ lazy/
        β”œβ”€β”€ system/
        └── web/

πŸ”§ Customization

Create Custom Profile

./profile.sh create my-dev

Edit lua/profiles/my-dev/init.lua:

require("config.options")
require("config.keymaps")
require("config.autocmds")

MiniDeps = require("mini.deps")
MiniDeps.setup({
  packages = {
    { source = "echasnovski/mini.nvim" },
    -- Your plugins
  },
})

-- Configure modules
require("mini.icons").setup()

See profiles guide β†’


πŸ“Š Profile Comparison

Feature default minimal full lazy system web
mini.nvim core βœ“ βœ“ βœ“ βœ— βœ“ βœ“
LSP βœ— βœ— βœ“ βœ— βœ“ βœ“
Treesitter βœ— βœ— βœ“ βœ— βœ“ βœ“
Completion βœ— βœ— βœ“ βœ— βœ— βœ“
Startup ~50ms ~30ms ~150ms ~10ms ~100ms ~100ms

πŸŽ“ Learning Resources


πŸ“„ License

MIT License - Feel free to use and modify as you wish!


πŸ“¬ Support

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors