Elegant profile manager for OpenCode. Switch between work, personal, and project configurations effortlessly.
npm install -g opencode-launcher# Show status
ocl
# List all profiles
ocl list
# Create a new profile (copies current config)
ocl create work -d "Work profile"
# Create an empty profile
ocl create minimal --empty
# Switch to a profile
ocl use work
# Show current profile
ocl current
# Show profile details
ocl show work
# Copy a profile
ocl copy work work-backup
# Edit a profile
ocl edit work
# Delete a profile
ocl delete work-backup
# Run opencode with a specific profile (temporarily)
ocl run personal .You can set a default profile for a specific directory by creating a .oclrc file:
# In your project directory
ocl init work
# This creates .oclrc containing "work"
# Now apply it:
ocl applyThe .oclrc file is searched upward from the current directory (like .gitignore), so you can set it at your project root.
# Example workflow
cd ~/projects/company-app
ocl init work # Creates .oclrc with "work"
ocl apply # Switches to work profile
cd ~/projects/personal-app
ocl init personal # Creates .oclrc with "personal"
ocl apply # Switches to personal profileWhen you run ocl with no arguments, it will show if a local .oclrc exists and whether you need to apply it:
opencode-launcher (ocl)
Elegant profile manager for OpenCode
★ Current: work
→ Local: personal (/Users/you/projects/personal-app/.oclrc)
Run ocl apply to switch
• 3 profile(s) available
| Command | Alias | Description |
|---|---|---|
ocl list |
ls |
List all profiles |
ocl current |
- | Show current active profile |
ocl create <name> |
new |
Create a new profile |
ocl use <name> |
switch |
Switch to a profile |
ocl delete <name> |
rm |
Delete a profile |
ocl edit <name> |
- | Edit profile in $EDITOR |
ocl run <name> [args] |
- | Run opencode with profile |
ocl copy <src> <dest> |
cp |
Copy a profile |
ocl show <name> |
info |
Show profile details |
ocl init <profile> |
- | Create .oclrc in current directory |
ocl apply |
- | Apply profile from .oclrc |
- Profiles are stored in
~/.config/opencode-launcher/profiles/ - When you
usea profile, it copies the config to~/.config/opencode/opencode.json - A backup is automatically created before your first profile switch
- The
runcommand temporarily switches profiles for a single session .oclrcfiles let you set project-specific default profiles
MIT