opencode-agents-localopencode plugin to load AGENTS.local.md as personal, per-project system instructions
2
12
3 in 7 days
20.6
Multi-signal model
6 months ago
2026-02-12
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": ["opencode-agents-local@1.0.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-agents-local@1.0.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-agents-localopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
An opencode plugin that loads AGENTS.local.md from your project directory into the system prompt.
Use it to inject per-project instructions that stay out of version control — ideal for personal preferences, local overrides, or machine-specific context.
Install
Add to your opencode.json:
{
"plugin": ["opencode-agents-local"]
}
Usage
Create an AGENTS.local.md in your project root:
<!-- AGENTS.local.md -->
- Always respond in Korean
- Use pnpm instead of npm
- The dev server runs on port 4000
The file contents are automatically appended to the system prompt on every chat.
Tip: Add
AGENTS.local.mdto your.gitignore— this is meant for personal, untracked instructions.
How it works
On each chat, the plugin:
- Looks for
AGENTS.local.mdin the working directory - If found and non-empty, appends its content to the system prompt
- If missing or empty, does nothing (no errors)
License
MIT