Every agent's model. One place. Codex on DeepSeek, Claude Code on Kimi, from the menu bar.
package agent
// JetBrains Air, JetBrains' agentic development environment, runs its own
// agents (Claude Agent, Codex, Gemini CLI, Junie) on the accounts signed in
// under Settings | Account | AI Providers: a sign-in or an API key, with no
// base URL of its own to point at magpie (AIR-4541 asks for one). What it
// does take is any agent that speaks the Agent Client Protocol, listed in
// acp.json in its config folder — ~/Library/Application Support/JetBrains/Air
// on macOS, $XDG_CONFIG_HOME/JetBrains/Air on Linux, %APPDATA%\JetBrains\Air
// on Windows — as
//
// {"agent_servers": {"<name in Air's agent menu>": {"command": …, "args": […], "env": {…}}}}
//
// and the models such an agent reports at session/new are its model menu
// in Air. So magpie adds an agent of its own there, "Magpie": OpenCode's ACP
// server (opencode acp), handed with OPENCODE_CONFIG a config file magpie
// keeps beside acp.json that has magpie's provider, its models, the one
// picked as the model a task starts on, and enabled_providers narrowed to
// magpie, so Air's menu lists magpie's models and routing groups and nothing
// of OpenCode's own. OpenCode merges that file over the user's own config
// and leaves the rest of it (their plugins, agents, MCP servers) as it is.
// Air's own agents, and the accounts they run on, aren't touched.
//
// Checked with OpenCode 2.0.20's opencode acp under a sandbox HOME, as Air
// starts it: session/new's model option lists magpie's models alone, the
// one set here current. Not with Air itself. One gap is OpenCode's: when a
// provider's key is in the environment it is started with (OPENAI_API_KEY,
// DEEPSEEK_API_KEY, … set, not empty), 2.0.20's ACP server lists that
// provider and none of its config's — this file's, the global one or a
// project's alike — so magpie's models don't show; an emptied key, or one
// kept in OpenCode's auth.json, doesn't do it.
import (
"fmt"
"os"
"path/filepath"
"runtime"
"strings"
"time"
"github.com/yetone/magpie/internal/appdir"
"github.com/yetone/magpie/internal/edit"
"github.com/yetone/magpie/internal/proc"
)
// airAgent is the name magpie's agent has in acp.json, and so in Air's
// agent menu.
const airAgent = "Magpie"
// airDir is where Air keeps its settings and acp.json.
func airDir(home, cfg string) string {
switch runtime.GOOS {
case "darwin":
return filepath.Join(home, "Library", "Application Support", "JetBrains", "Air")
case "windows":
d := appdir.Getenv("APPDATA")
if d == "" {
d = filepath.Join(home, "AppData", "Roaming")
}
return filepath.Join(d, "JetBrains", "Air")
}
return filepath.Join(cfg, "JetBrains", "Air")
}
// airOpenCode is the OpenCode Air is to start: the one on PATH, else the
// one OpenCode's installer puts in ~/.opencode/bin, as a full path, since
// Air, an app, may not have the shell's PATH; "" when there is none.
var airOpenCode = func(home string) string {
if p, err := proc.LookPath("opencode"); err == nil {
if abs, err := filepath.Abs(p); err == nil {
return abs
}
return p
}
name := "opencode"
if runtime.GOOS == "windows" {
name += ".exe"
}
if p := filepath.Join(home, ".opencode", "bin", name); isFile(p) {
return p
}
return acpOpenCode(home, name, runtime.GOOS)
}
// acpOpenCode is an OpenCode a JetBrains IDE or Zed installed from the ACP
// registry, unpacked into the editor's own folder and on no PATH (#2423:
// IDEA's at ~/Library/Caches/JetBrains/IntelliJIdea2026.2/acp-agents/
// opencode/1.19.0/opencode); the newest when there are several, "" when
// none.
func acpOpenCode(home, name, goos string) string {
var globs []string
switch goos {
case "darwin":
globs = []string{
filepath.Join(home, "Library", "Caches", "JetBrains", "*", "acp-agents", "opencode", "*", name),
filepath.Join(home, "Library", "Application Support", "Zed", "external_agents", "registry", "opencode", "*", name),
}
case "windows":
local := appdir.Getenv("LOCALAPPDATA")
if local == "" {
local = filepath.Join(home, "AppData", "Local")
}
globs = []string{
filepath.Join(local, "JetBrains", "*", "acp-agents", "opencode", "*", name),
filepath.Join(local, "Zed", "external_agents", "registry", "opencode", "*", name),
}
default:
cache := appdir.Getenv("XDG_CACHE_HOME")
if cache == "" {
cache = filepath.Join(home, ".cache")
}
data := appdir.Getenv("XDG_DATA_HOME")
if data == "" {
data = filepath.Join(home, ".local", "share")
}
globs = []string{
filepath.Join(cache, "JetBrains", "*", "acp-agents", "opencode", "*", name),
filepath.Join(data, "zed", "external_agents", "registry", "opencode", "*", name),
}
}
best, at := "", time.Time{}
for _, g := range globs {
ps, _ := filepath.Glob(g)
for _, p := range ps {
fi, err := os.Stat(p)
if err != nil || !fi.Mode().IsRegular() {
continue
}
if best == "" || fi.ModTime().After(at) {
best, at = p, fi.ModTime()
}
}
}
return best
}
func air(home, cfg string) *Agent {
dir := airDir(home, cfg)
path := filepath.Join(dir, "acp.json")
// the OpenCode config magpie's agent runs on, magpie's own file
ocPath := filepath.Join(dir, "magpie-opencode.json")
entry := "agent_servers." + airAgent
provider := openCodeKept(ocPath, func() any { return magpieProviderJSONFor("opencode", "air") })
// ours: acp.json's Magpie is the agent magpie added, on its file
ours := func() bool {
v, _ := edit.GetJSON(path, entry+".env.OPENCODE_CONFIG")
return v == ocPath
}
// model is the one a task starts on, read from magpie's own file: with
// Magpie gone from acp.json it still reads, for Check to say so and a
// set again to put the entry back
model := func() string { v, _ := edit.GetJSON(ocPath, "model"); return v }
return atomic(&Agent{
ID: "air", Name: "JetBrains Air", Icon: "air", Aliases: []string{"jetbrains-air"},
// no Bin: air is other tools' name too (Go's live reloader); its
// requests are its OpenCode's, and counted as OpenCode's
Dir: dir, Path: path,
Notice: func() string {
if !ours() {
return ""
}
if airOpenCode(home) == "" {
return noticeAir1.String()
}
return noticeAir2.String()
},
Check: func() string {
if !usesMagpie(model()) {
return ""
}
if !ours() {
return "Air's Magpie agent (" + filepath.Base(path) + ") is gone, so Air no longer reaches magpie"
}
return wiringOff("Air", ocPath, func(k string) (string, bool) { return edit.GetJSON(ocPath, "provider."+magpieID+".options."+k) },
"baseURL", gatewayV1(), "apiKey", hereKey())
},
Sync: func() error {
return syncJSONInOrder(ocPath, "provider."+magpieID, provider)
},
Fields: []Field{{
Key: "model", Label: "model",
Get: model,
Set: func(v string) error {
if v == "" {
if err := edit.DelJSON(path, entry); err != nil {
return err
}
if err := edit.Remove(ocPath); err != nil && !os.IsNotExist(err) {
return err
}
return nil
}
ref, ok := strings.CutPrefix(v, magpieID+"/")
if !ok || !isMagpie(ref) {
return fmt.Errorf("Air takes only magpie's models here (its own agents are picked in Air): %s isn't one", v)
}
// each key new to the file goes in at its top: last first,
// so a new file reads $schema, model, …, provider
if err := edit.SetJSON(ocPath,
edit.KV{Path: "provider." + magpieID, Value: provider()},
edit.KV{Path: "enabled_providers", Value: []string{magpieID}},
// titles and summaries too, as the user's own small
// model may be a provider left out here
edit.KV{Path: "small_model", Value: v},
edit.KV{Path: "model", Value: v},
edit.KV{Path: "$schema", Value: "https://opencode.ai/config.json"}); err != nil {
return err
}
bin := airOpenCode(home)
if bin == "" {
bin = "opencode"
}
return edit.SetJSON(path, edit.KV{Path: entry, Value: map[string]any{
"command": bin, "args": []string{"acp"},
"env": map[string]string{"OPENCODE_CONFIG": ocPath},
}})
},
Options: func(map[string]string) []Option { return viaMagpie("air", magpieID+"/") },
}},
}, path, ocPath)
}
// what air says after a change (notice.go)
var (
noticeAir1 = newNotice("Air runs magpie's models through OpenCode's ACP server, and OpenCode isn't installed here: install OpenCode (npm i -g opencode-ai), then pick Magpie in a new Air task.")
noticeAir2 = newNotice("In Air, start a new task and pick Magpie in its agent menu: magpie's models and routing groups are in its model menu.")
)