Opencode Profile Router

Tiny profile wrapper for OpenCode.

Compatible with the opencode version in .opencode-version.

OpenCode supports custom config and data locations through environment variables, but it does not have a built-in profile system for multiple auth contexts from the same provider. For example, separate personal and work ChatGPT logins are not supported out of the box.

opencode-router adds a lightweight profile layer on top of OpenCode. Each profile can have its own auth state, data root, and OpenCode config, with optional full config isolation when needed.

This is also useful when you want to use your company or team OpenCode setup, such as shared harnesses, skills, or tools, without interfering with your personal workflow. With full config isolation, a profile can behave like a separate global OpenCode setup.

This is different from a project .opencode/ setup. V2 discovers project config from the current directory up to the filesystem root. It can override config for that project, but it does not provide separate provider login state by itself.

With opencode-router, you can:

• define named profiles with separate auth and data roots;
• route profiles by path. E.g.: "always open work profile for anything under ~/work" instead of your normal opencode profile, unless bypassing with opencode-router profile default;
• use profile-specific OpenCode config;
• optionally fully isolate config. By default, profiles still inherit your shared global OpenCode config. Full isolation is optional.
• For the brave and true, opencode-router can also intercept the opencode command so routing happens automatically from your shell when calling opencode. This is convenient, but also more prone to bugs and fragile than calling opencode-router explicitly.

Quick Start

This is essentially a shell script, so you can make your own setup. Just make sure it can be called from anywhere. The recommended one, however, is as follows:

git clone https://github.com/leolaurindo/opencode-profile-router ~/.local/share/opencode-profile-router
mkdir -p "$HOME/.local/bin"
ln -sf "$HOME/.local/share/opencode-profile-router/opencode-router" "$HOME/.local/bin/opencode-router"
chmod +x "$HOME/.local/share/opencode-profile-router/opencode-router"

# Add to PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

Optionally, create an easy alias:

echo 'alias ocr="opencode-router"' >> ~/.bashrc
echo 'alias opr="opencode-router"' >> ~/.zshrc

Updating

If you installed opencode-router from the recommended Git clone path above, update it with:

git -C "$HOME/.local/share/opencode-profile-router" pull --ff-only

--ff-only keeps the update predictable: it only moves your local clone forward when there are no divergent local commits, and refuses to create an automatic merge.

Setup your first profile:

opencode-router new work "$HOME/work"
opencode-router profile work auth login
cd "$(opencode-router show work --config)"
# edit opencode.jsonc here using normal OpenCode config syntax
opencode-router "$HOME/work/my-repo"

See DOCS.md for commands, routing details, managed paths, config layering, and shell setup.

OpenCode V2

Profiles use private servers and always isolate XDG_STATE_HOME so the default background service cannot supply another profile's credentials. The router creates service.json with disabled: true in a profile if that file is missing; existing service settings are not overwritten. Plain/default invocations are unchanged. The old OCR_USE_V2=1 selector still works, but now defaults to the installed ~/.opencode/bin/opencode; OPENCODE_V2_BIN can override it.

Intercepting opencode

See DOCS.md or opencode-router --help to understand how opencode args are passed through. OpenCode's run command is passed through too, so opencode-router run -i executes opencode run -i.

alias opencode="opencode-router"

Or:

opencode() {
  opencode-router "$@"
}

You can bypass the wrapper with command opencode or by forcing opencode profile default.

Contributing

Issues and pull requests are welcome.

Checks

sh -n opencode-router
python3 -m unittest -v test_router.py

TODOs

• add a script for automating the allowlist verification

License

0BSD. See LICENSE.