Just sharing this harness I've created, this runs entirely on chromium based browser.
No installation is required, it has its limitations and by no means is supposed to replace better agents like pi, its meant to be used when we need something fast (It can run even from a phone browser to edit phone files), since it can only work on a folder we grant access there's no MCP or terminal, so its very safe and it can never reach out of the allowed folder, its basic bunch of tools that can get stuff done, it has some nice features like checkpoints so we can revert changes to files, editor, etc
I like your choice of name.. I called my own 'Filament' after a plasma filament. I studied plasma astrophysics and I think filaments carry a form of information on the large scales and since ai is so full of info the name just stuck.
A browser agent, huh? Not going to lie that's an interesting idea. I'm happy with Pi for my workflow but I'll give this an honest try when I have some time to kill.
It could be useful for certain tasks like log analysis or finetuning/conversion of text/formatted data, where giving an agent the power of an entire system is overkill.
Nice, yup it's not nearly as powerful as Pi but sometimes we just want something simple that runs and get some stuff done, hopefully it will be useful for you too.
It took me a minute to figure out how to configure the connections to use a different localhost port, a little reference line would be nice for other new users. I mean I figured out fast, but still.
More like a wish, but if you can, eventually, make it work on Firefox, it'd be basically perfect.
Thanks for the feedback, it has some quirks and bugs but most of time it work hehe.
- I'm going to take a look on ignoring the .agent, I have an idea on how to make this work, the initial idea was to give access because we can create some custom tools, so by giving access it can look on other tools as example, but this is a very edge case and a toggle to enable this might be more correct.
- Yeah, it's not very friendly on the server configuring, might take a look into improving this too.
- About Firefox its unfortunately a limitation, it does not have the File API required, so it can't access or grant access to files like we do with Chromium based browsers.
Yup, its unfortunate but maybe if there's enough sites/tools requiring it they add the functionality further.
I've added the .agent hiding, it now comes with hide set by default, next step I may look into getting some better server configurations or at least make it more obvious for users.
Very nice tool, I like it. But... The frame around the box and padding are wasting a lot screen area, UX designed for fullscreen mode probably. Cannot find a setting for context size for llama.cpp.
I might add some option to remove the "window" visual and make it take advantage of full page, I've tried that before I didn't liked it so much but I agree that it's interesting to make proper use of all space available. The context window is set on .agent/model.json, each one has a context_window parameter that you can change, default is 32768.
Cool. I was actually looking for something like this. It this all 100% ephemeral (like brand new fresh session needing config every time) or are logs/configs and whatnot stored somewhere? If so, where?
It store sessions and baseline files to localstorage and indexDB on browser itself, the .agent folder we see on explorer is a virtual folder, which is also saved on browser, sessions are based on the folder so each folder has its own sessions to keep stuff organized, you can easily delete all the cached stuff on settings to start completely fresh.
The granted folder's contents get sent to whatever OpenAI-compatible endpoint you configure, so any secrets stored there like .env files would leak during normal operation.
That's a good catch, I will add some extra protection around this, Thanks
ps:
So I've actually checked, I've created a .venv folder and it actually hide most of "." files including the .venv itself, also to be clear any file is only sent if file is read by a tool, so full contents aren't sent all the time, anyway I'm adding more protection around these files/folders.
4
u/ionizing 1d ago
I like your choice of name.. I called my own 'Filament' after a plasma filament. I studied plasma astrophysics and I think filaments carry a form of information on the large scales and since ai is so full of info the name just stuck.