Hi,

I have created a new plugin to enable you to embed multiple coding agents into a native tab. Supporting multiple sessions (sub tabs).

You can use it for coding, monitror and manage your server, add MCP servers and do cool things etc. or whatever floats that boat of yours!

It's on the CA Store, else you can manually install from here: https://raw.githubusercontent.com/johnpwhite/unraid-plg-aicliagents/main/unraid-aicliagents.plg

It will pull (on install) a few public packages (tmux, node, npm etc.) so if you're uncomfrtable with this, review the plg file contents first so you can see what it pulls.

I'd love your feedback, feature request, security concerns etc.

Work space manager pops out, create new, manage ENV variables, upload screenshots/files, instantly switch between workspaces and agents:

Example view of agent running:

Jump into a home & work space mapped temp shell while into your flow:

Install, upgrade, remove agents:

Manage storage of agents and home:

Edited May 28May 28 by johner
new plugin version, new agents!

Hi,

I wanted to start by saying that unraid-aicliagents is a great plugin! I was able to install it and get it working right away, and I’ve really been enjoying using it.

However, I did notice one small issue: the cli_help sub-agent in Gemini CLI is currently broken. When asked a question, it returns the error: "Error: Could not find Gemini CLI documentation directory."

The Issue:

The gemini-cli agent expects an internal docs/ directory (containing sidebar.json and markdown files) to be present relative to the aicli.mjs binary. Currently, the gemini-cli.tar.gz package in the plugin's /pkg-cache/ folder only contains the single aicli.mjs file, so the documentation is missing when the agent is deployed to RAM.

The Fix:

Could you please update the build process to include the docs/ folder from the Gemini CLI repository (https://github.com/google-gemini/gemini-cli/tree/main/docs) inside the gemini-cli.tar.gz archive? Including these files would allow the cli_help agent to function correctly, providing users with a built-in knowledge base for commands, MCP setup, and configuration.

Thank you for the great plugin and for all your hard work!

Also, a quick suggestion regarding Flash Drive wear:

Currently, the plugin defaults the HOME directory (where .gemini history and logs are stored) to the USB flash drive. Since every chat turn writes to these files, it causes frequent writes to the flash.

It would be great if the plugin settings allowed us to point the "Agent Home" to an appdata share on the array or cache instead. This would:

1. Protect the USB drive from long-term wear.

2. Improve performance when loading large chat histories.

I’ve manually moved mine to /mnt/user/appdata/gemini-cli for now, but having it as a built-in option in the UI would be a fantastic feature for all Unraid users.

6 hours ago, Sanjay said:

Hi,

I wanted to start by saying that unraid-aicliagents is a great plugin! I was able to install it and get it working right away, and I’ve really been enjoying using it.

However, I did notice one small issue: the cli_help sub-agent in Gemini CLI is currently broken. When asked a question, it returns the error: "Error: Could not find Gemini CLI documentation directory."

The Issue:

The gemini-cli agent expects an internal docs/ directory (containing sidebar.json and markdown files) to be present relative to the aicli.mjs binary. Currently, the gemini-cli.tar.gz package in the plugin's /pkg-cache/ folder only contains the single aicli.mjs file, so the documentation is missing when the agent is deployed to RAM.

The Fix:

Could you please update the build process to include the docs/ folder from the Gemini CLI repository (https://github.com/google-gemini/gemini-cli/tree/main/docs) inside the gemini-cli.tar.gz archive? Including these files would allow the cli_help agent to function correctly, providing users with a built-in knowledge base for commands, MCP setup, and configuration.

Thank you for the great plugin and for all your hard work!

Hi, I changed the approach to use npm yesterday, I haven’t pushed to GitHub yet as working through a couple defects on new features. I’ll try and get it out tonight or tomorrow (I’m in Australia).

I can change the default but I wanted it to work with the array down and didn’t want to risk losing anything. I’ll get Gemini to add a backup feature :-)

The location can be changed on the settings page.

Thanks for your feedback!

Edited March 13Mar 13 by johner

On 3/14/2026 at 7:32 AM, Sanjay said:

Also, a quick suggestion regarding Flash Drive wear:

Currently, the plugin defaults the HOME directory (where .gemini history and logs are stored) to the USB flash drive. Since every chat turn writes to these files, it causes frequent writes to the flash.

It would be great if the plugin settings allowed us to point the "Agent Home" to an appdata share on the array or cache instead. This would:

1. Protect the USB drive from long-term wear.

2. Improve performance when loading large chat histories.

I’ve manually moved mine to /mnt/user/appdata/gemini-cli for now, but having it as a built-in option in the UI would be a fantastic feature for all Unraid users.

Hi Sanjay.

I have updated the plugin, quite a few changes, a couple for you to test:

1) Gemini CLI now installs via npm like the others, you might need to uninstall then reinstall. Hopefully the docs are now there - i'm not sure what to look for to test.

2) I changed the active location for home to be /tmp/... this gives the highest performance, removes the wear concern, but you'll lose it on reboot

3) The plugin will allow you to manually back up on click of a button in settings, on a schedule, or automatically when all workspaces are closed. It backs up to usb as on reboot it will restore back into ram.

4) currently you can't change the home path due to the above changes, if you really want to make it editable again, let me know, but using the array defeats the point of the plugin of being there to help when you have array, or docker issues etc.

Thanks

John

Edited March 17Mar 17 by johner

Thanks for the plugin, can you update it so that the left side isn't buried under the unraid menu? i have the left side menu configured and the start of the prompt is underneath the left side menu

1 hour ago, Lygris said:

Thanks for the plugin, can you update it so that the left side isn't buried under the unraid menu? i have the left side menu configured and the start of the prompt is underneath the left side menu

can you send a screen shot please? I'm not familiar with what the left side menu is, i'll go investigate though as curious now!

UPDATE: I had a quick check of settings, and a google search, it appears you're using a custom theme - is that right? If not, can you point me to where the setting is please?

This is how it renders on mine with the regular menu:

The tab on the left to open the drawer can be moved up and down.

Edited March 17Mar 17 by johner

Hey, cant seem to find a way to add mcp server to cli´s (in my case claude, which would usually be done with `claude mcp add`). Is there a way?

18 minutes ago, Joly0 said:

Hey, cant seem to find a way to add mcp server to cli´s (in my case claude, which would usually be done with `claude mcp add`). Is there a way?

Hi,

Try the new version. You should now be able to drop into the normal unraid shell (top right icon) or ssh:

The commands are mapped to your persistant home and aliased, so you should now be able to run claude mcp add etc.

Let me know how you go

Thanks

John

5 hours ago, johner said:

Hi,

Try the new version. You should now be able to drop into the normal unraid shell (top right icon) or ssh:

The commands are mapped to your persistant home and aliased, so you should now be able to run claude mcp add etc.

Let me know how you go

Thanks

John

Yes, works. For some reason after installing the claude command was not there (installed it 2 days ago; always showed claude as not available command), but now its working as it should.

Another thing i noticed, not sure if its a bug or intended, i do not have gemini cli installed, only claude. When i create a new workspace it shows in the popup on top "claude", so i assumed it would use calude then. But when i created the workspace i got the error, that gemini-cli was not installed. I had to remove the workspace, create a new one and click on "claude" separetely to make the workspace use claude. The "claude" button also gets a yellow-ish border were before its grey. Though when i create a new workspace in the same tab as before, i do not ahve to select claude again.

Something else that is kinda annoying is, that i cannot scroll up or down in the cli itself. I can only scroll through my inputs, but i cannot see earlier repsponses

44 minutes ago, Joly0 said:

Something else that is kinda annoying is, that i cannot scroll up or down in the cli itself. I can only scroll through my inputs, but i cannot see earlier repsponses

Is this in Claude? In Gemini I had to change a setting to use alt screen buffer. Have a google to see if something similar on the Linux version of Claude.

I’ll review the other response too.

4 hours ago, Joly0 said:

Yes, works. For some reason after installing the claude command was not there (installed it 2 days ago; always showed claude as not available command), but now its working as it should.

Another thing i noticed, not sure if its a bug or intended, i do not have gemini cli installed, only claude. When i create a new workspace it shows in the popup on top "claude", so i assumed it would use calude then. But when i created the workspace i got the error, that gemini-cli was not installed. I had to remove the workspace, create a new one and click on "claude" separetely to make the workspace use claude. The "claude" button also gets a yellow-ish border were before its grey. Though when i create a new workspace in the same tab as before, i do not ahve to select claude again.

Sounds like a bug or two! I’ll try and fix those.

Hi,

just updated the plugin and all my VMs went off, afterwards also my server rebooted. Mmh..

It was directly during the update and my server is normally very, very stable…

Can you check that?

Thanks

Edited March 30Mar 30 by Unraider_

Hi,

Yes I had a similar issue with VMs stopping.

There is a chance the RAM disk got exhausted, I’m working on moving the installers back to usb / alternative.

In the interim, if you google ‘Unraid increase RAM disk’ or the like, you should be able to give it some breathing room.

Else/and uninstall any agents you’re not using often until I fix.

Thanks for reporting.

15 hours ago, johner said:

Hi,

Yes I had a similar issue with VMs stopping.

There is a chance the RAM disk got exhausted, I’m working on moving the installers back to usb / alternative.

In the interim, if you google ‘Unraid increase RAM disk’ or the like, you should be able to give it some breathing room.

Else/and uninstall any agents you’re not using often until I fix.

Thanks for reporting.

My VMs also go off when i start AICLIAGENTS from the UI…

To which size should the RAM disk be set? Best practices?

I’ve nearly finished a version which changes the approach to avoid these issues, I’m about to sleep, so will work on it tomorrow, should be available in about 12-18h hopefully if no major issues.

Hey, two other things i noticed is that the sync is running indefinitely (atleast for me was running for over 10 minutes and didnt finish) and the schedule for that is not saved nor applied in any way, so saving doesnt work

Also could you explain how and where the different cli´s are installed, cause i would like to use things like claude code usage monitor or meridian/opencode-with-claude and they require things like the opencode.json file or the config location for claude, and i cannot find them. I searched under /tmp/unraid-aicliagents but couldnt find for example the opencode.json file

why store on usb at all? why not use cache/pool?

agents are not static, they have new versions all the time, they have skills, configs, tools.

its a very bad idea to keep that on the boot usb,

because I need it to run when the array is offline, which is the reason to not use docker.

I've nearly finished testing an upgrade that allows a user to run agents from usb (read only) and home in ram and occasionally backed up to USB to (deltas) to minimise USB wear. With it a user will be able to move the agent store and/or home to arrary (if you don't mind it not being available when stopped), or ideally to an unassigned device mount which will still be available when the array is stopped.

I tried this out and CONTINUALLY run into the SQLITE database is full error. It's very annoying. I also can't install all the different agent plugins because I can't seem to expand the agent binary storage past 4GB. I've already tried moving to /mnt/nvme/appdata but still run into problems. Am I doing something wrong?

On 4/1/2026 at 10:34 AM, Joly0 said:

Also could you explain how and where the different cli´s are installed, cause i would like to use things like claude code usage monitor or meridian/opencode-with-claude and they require things like the opencode.json file or the config location for claude, and i cannot find them. I searched under /tmp/unraid-aicliagents but couldnt find for example the opencode.json file

so in the new version there is a dedicated loop back file called agent.img on the USB (by default), it is mounted /usr/local/emhttp/plugins/unraid-aicliagents/agents

Btw, just did the latest update with the migration and everything and afterwards the directory /tmp/unraid-aicliagents/work/root/ was empty, so all sessions, configurations, etc were gone. I had to manually copy back those files from the backup location under /boot/config/plugins/unraid-aicliagents/persistence/root

Also another thing i have noticed: When i have to debug mcp servers using npm/npx they do not use the correct paths and usually defualt back to /root/ directory instead of the /tmp/unraid-aicliagents/work/root/. Even when starting them like this /usr/local/emhttp/plugins/unraid-aicliagents/bin/npx it doesnt work either and they still usually place their place under /root/. It would be great here if there was some way to easily get into the same environment as cli´s would run under. I assume you are doing some path shenanigans or something similar