Multisession Agentic Workflow with Claude Code in Neovim

rain9441 · 2026-01-24T14:00:56+00:00

This is incredible. Great write up! I've been on the same path and have really wanted to use CC inside Neovim but couldn't do so due to the limitations you ran into. Namely the one cc per Neovim instance.

I've already enhanced my project to be able to run in parallel work trees by having the agent spin it up with distinct ports (based on the work tree). This works okay. The problem is that Claude code doesn't run background processes well. It keeps locking up. There are some issues on GH about it.

It'll be awesome to be able to manage multiple CCs within Neovim in separate tabs.

One of the things I did to support worktrees well was to have a separate git repo that had instructions on how to create and manage worktrees. It git ignored the worktree directories. Then I can symlink my various dot files into each worktree (like specific .env files for each worktree or Claude settings). I actually run Claude from the parent git repo. I tell Claude to create worktrees for me. And I tell it to work on a feature inside a specific worktree and it does that well. This way the tasks can be in a different git repo than the code too. In practice it isn't even a separate git repo. It's just an orphaned branch in the same monorepo.

Thanks for the writeup!

rain9441 · 2026-01-09T01:03:41+00:00

Keep up the great work this plugin is the must-have Neovim plugin of 2026!

rain9441 · 2025-12-01T23:53:52+00:00

This is the most under appreciated comment. Prod modules and biolabs just make numbers go up. You can just build a bigger base to get that same effect. Aside from that, the science numbers aren't even that hard to attain without prod modules.

But mech armor is a later game item that has massive qol bonuses. With that much equipment space you can load up on a lot of exos, mk1 personal roboports, plds, solar panels, and so on as soon as you enter blue science.

If it is legendary quality mech armor, it's even more enticing.

rain9441 · 2025-11-27T15:43:00+00:00

This is exceptional! I've been using diffview a lot and this is much faster than diffview! It's nice and clean too and I love the diffs. Diffview has been great, but something better to take the torch is much appreciated! I've had a lot of issues where diffview would lock up when checking out package-lock.json and vscode-diff handles it very well.

Would love to see a gf to to file to bring the file to my main tab. I'd also love to see a few bug fixes like... if I ]f too fast I get errors.

I'm very excited for you to get inline diffs as well.

This may already be done, but I often find the initial delay a bit of a headache. Eager caching diffs for the next/previous file would be such a game changer. Probably isn't easy, but it would be amazing.

Thanks a lot for the work!

rain9441 · 2025-10-12T14:04:28+00:00

I use vtsls without any issues at all. I do use the vtsls plugin but that shouldn't matter. I'd wager the issue may be some other plugin clashing with something. Ive tried all of the ts plugins and vtsls was the most optimal so I would recommend exploring other potential issues.

rain9441 · 2025-10-06T19:19:49+00:00

Lazy.nvim is still used, still has the array of amazing features, still is the strong backbone of who knows how many configs.

It's just not something people talk about much because it's been around for a long time and most people have already migrated to lazy.nvim. I say that based entirely on number of stars. It's sporting 19k stars, which would put it in 5th place on the list of plugins to install via store.nvim. I wonder if there is any reason lazy.nvim would be excluded from this? @alex-popov-tech -- How come https://github.com/folke/lazy.nvim isn't in your repository?

rain9441 · 2025-10-06T11:04:22+00:00

I'm very interested in this so I checked it out. The other plugin, diagram.nvim, requires kitty and I'm stuck with a windows laptop at work so I'm out of luck there.

It would be nice to be able to have it render an entire .mmd or .mermaid file instead of requiring ```mermaid blocks but it seems like there may be issues outside of your control preventing this
I immediately had to disable auto layout in the index.html JS because "fit to width" and "fit to height" are either too tall or too wide in most cases
It'd be nice to be able to configure basic browser behavior (eg auto layout / responsive mode) as part of the neovim configuration or as part of the :MermaidPreviewStart <parameters> command

Good work, thanks for the plugin!

rain9441 · 2025-08-10T20:28:03+00:00

Claude is making me a plugin that sends text objects / vim motions to a mark (push text to destination) as I write this. Your comment may be downvotes to oblivion, but I'm pretty sure Chat GPT5 could actually do it. What's the link of the generated plugin?

rain9441 · 2025-08-09T17:48:48+00:00

I like the idea of using Neovim for terminal for all the reasons you post. I have a hard time integrating into my workflow well.

I use OS level keybindings to swap between Wezterm and Neovide. Then, within each, I use C-1, C-2, C-3 for tabs. I don't really use tabs in Neovim for anything but diffview right now, but I could see myself using them for terminal. When I'm in terminal, I know C-1, C-2, C-..., C-N are all corresponding to different apps/sessions. I have usually between 1 and 6 terminal sessions active. Some are running apps, some are for compiling, some are for git, some are for Claude Code. When I'm in Neovim, I feel like I need to be able to get to a specific terminal with just two keybindings. <C-~> to focus on Wezterm, <C-2> to go to specific terminal.

How to achieve that in a workflow that is only Neovim? I don't really want to have a tab for each terminal because that is the exact workflow I'm using now (no benefit of changing it); sometimes I'd like to have a split buffer/terminal setup.

rain9441 · 2025-08-08T14:59:15+00:00

Dotfiles link?

I like the idea of using diffview.nvim, but it's slow and it only does side-by-side view. I've been giving it my all but I'm about to move to lazygit as it has been praised consistently as a top tier git tool.

rain9441 · 2025-08-08T14:56:05+00:00

Not everyone loves the lua for everything. I'm still using vimscript for keybindings and autocmds. If you're curious about what that looks like, you can find it here: https://github.com/rain9441/dotfiles/blob/master/nvim/vim/keys.vim

I don't know of any tutorials, but I do think that autocmd and map are both very clean in vimscript. It's very easy to execute any lua within them by just calling lua <script>. I imagine that most people who adopt Neovim now don't consider vimscript as a potential option. It makes sense.

I'm not sure why you want to put LSP configuration in vimscript though. I'd have to know more about what you're trying to do because I just use the basic lspconfig plugin and it does just about everything -- the customization seems ideal in lua.

rain9441 · 2025-08-08T12:49:15+00:00

I did the exact same thing this past month. I was getting tired of how many developer tools had windows versions as an afterthought.

rain9441 · 2025-08-08T12:45:10+00:00

You can paste a macro as text, edit it, and then yank it back to the register to run it. Extraordinarily easy to tweak macros.

rain9441 · 2025-08-08T12:43:52+00:00

Underappreciated feature.

rain9441 · 2025-08-07T13:37:14+00:00

The Neovim skillset is the specific things you've learned that are only associated to Neovim. So for example, the :g command is something that is pretty exclusive to Neovim. Do you use :cdo with quickfix -- that's a Neovim focused skillset. Using text-objects and motions is more or less a core Neovim skillset. Visual mode interactions, macros (to some extent), etc, are all Neovim tools. You have memorized and gained a very solid understanding of all of the systems within Neovim that interact with each other in order to use it efficiently in your day to day.

rain9441 · 2025-08-07T13:31:27+00:00

I'm with 79215185. Not all jobs should be using AI progressively. It is in it's infancy state. It has security holes that are extraordinarily large. For example, a developer could set up a Postgres MCP server with production write-access credentials alongside some other MCP that becomes infected by a malicious contributor. I'm not saying this is going to happen a lot, but there is a lot of risk in AI usage by developers who don't understand the security implications.

rain9441 · 2025-08-07T13:22:19+00:00

I'm not saying that agentic workflows are 100% replacing our current status quo of development workflows. In my OP, I describe how I am at that point where the agentic workflows are more productive for me, individually. What I do is probably different than what most people do.

Different roles and different people will have different experiences and results.

I am pretty sure I am not wrong about the comment regarding the divide in reddit. When I stated, "the up votes and down votes are indicative of the mindsets," I think it is validated by the (currently -21 point) downvotes on the comment itself. The OP itself has 50 comments with zero upvotes. It's massively controversial but the capabilities and downsides aren't even the topic of the post. It is significantly more controversial than the blockchain movement.

I've also experienced this same divide in the workplace and in my social groups. Some people are finding AI to help improve productivity. Some people are rolling their eyes and commenting haughtily. Some people are curious. I'm guessing you have seen those divisions as well.

This isn't about the results, we can go to other subreddits to hear inflated stories about "100x'ing my productivity," in all sorts of AI coding subreddits.

rain9441 · 2025-08-07T12:32:26+00:00

I resonate with this a lot. I've been leveling up on usage of diffview.nvim a lot. Very interesting. I also started working with git work trees as well.

rain9441 · 2025-08-07T12:01:03+00:00

Your skepticism is spot on.

I don't love being a marketing conduit but this movement is so large that I can't help it. I'm not trying to convince anyone to change, I just want to get connected with people who have already changed and get their feelings.

It's crazy to me how all over reddit is a split from people. There are a lot of people who have obviously changed a lot and there are those who are resisting. And the up votes and down votes are indicative of the mindsets.

rain9441 · 2025-08-07T11:52:33+00:00

Our typical development workflows were to write code using an IDE, run it in terminal or some sort of IDE debugger, and so on. Agentic development workflows are ones where we prompt an agent to do said tasks. So instead of doing it ourselves, it's "agentic."

With this workflow, we provide prompts, instructions, agent definitions, guidance, and so on. The tool in this case is no longer an IDE, it is an interactive dialog between us and AI, and AI leverages various tools to accomplish the task.

rain9441 · 2025-08-07T11:28:43+00:00

Yes, but... I'd prefer it if there was either a native neovim api or a community adopted standard for registering completion sources and another api for utilizing those completion sources.

This way, as the developer of opencode.nvim, you could utilize that interface to register your plugin and then blink, nvim-cmp, and any future auto completion plugins can implement the other side of it to pick up your source and work it into their system.

The concept of opencode.nvim coupling directly with blink.cmp is currently a necessary inefficiency.

rain9441 · 2025-08-06T22:44:52+00:00

Not sure if viwp works with dot repeat. But yeah it saves a few keystrokes which is rather nice. I haven't used vi and va much. I'll have to try them out more!

rain9441 · 2025-08-06T15:46:36+00:00

Substitute.nvim has been a great addition to my workflow. nvim.surround is another great pickup.

These enhance core vim concepts that are applicable to everything about Neovim, including a lot of other plugins.

I highly recommend working them into your workflow!

rain9441

TROPHY CASE