@dougbots/opencode-image-loaderImage-to-base64 tool for opencode — lets image-capable models see local image files
0
11
2 in 7 days
23.7
Multi-signal model
1 month ago
2026-06-22
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@dougbots/opencode-image-loader@0.1.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@dougbots/opencode-image-loader@0.1.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D @dougbots/opencode-image-loaderopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
Image-to-base64 tool for opencode — lets image-capable models see local image files from the filesystem.
What it does
Registers an image_to_base64 tool that:
- Reads an image file from disk (png, jpg, gif, webp, svg, bmp, tiff)
- Converts it to a base64 data URL with the correct MIME type
- Returns the image as a file attachment that vision-capable models can process
Install
npm install -g @dougbots/opencode-image-loader
Then add to your opencode.json plugins array:
{
"plugin": [
"@dougbots/opencode-image-loader"
]
}
Usage
Once installed, the image_to_base64 tool is available in your opencode sessions. Pass it a file path and it returns the image as a base64-encoded data URL:
image_to_base64(filePath: "/path/to/image.png")
Supported formats: png, jpg, jpeg, gif, webp, svg, bmp, tiff.
Response
The tool returns:
- A text confirmation of the conversion
- A file attachment with the base64 data URL and MIME type
- Metadata (
mimeType,fileSize,path)
Dependencies
- @opencode-ai/plugin — the opencode plugin runtime