Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Studio: list VS Code and Pi as coding agents and reorder the agent picker (#13547)

Michael Han0b81fb88baf3
diff --git a/studio/backend/tests/test_coding_agents.py b/studio/backend/tests/test_coding_agents.py
index 7c068190229..e5b86654532 100644
--- a/studio/backend/tests/test_coding_agents.py
+++ b/studio/backend/tests/test_coding_agents.py
@@ -22,15 +22,24 @@ def test_matches_unsloth_start_subcommands():
assert CODING_AGENTS == (
"claude",
"codex",
- "openclaw",
+ "vscode",
+ "dsh",
"opencode",
"hermes",
+ "openclaw",
"pi",
- "dsh",
"vibe",
)
+def test_detects_vscode_by_its_code_launcher():
+ with patch(
+ "utils.coding_agents.shutil.which",
+ side_effect = lambda name: "/usr/local/bin/code" if name == "code" else None,
+ ):
+ assert detect_installed_coding_agents() == ["vscode"]
+
+
def test_detects_only_agents_present_on_path():
installed = {"claude", "opencode"}
with patch(
diff --git a/studio/backend/utils/coding_agents.py b/studio/backend/utils/coding_agents.py
index 7c419be8d1e..67d93fe0d77 100644
--- a/studio/backend/utils/coding_agents.py
+++ b/studio/backend/utils/coding_agents.py
@@ -24,20 +24,23 @@ _DEEPSEEK_HARNESS_FILE_MARKERS = (
)
# Keep in sync with the `unsloth start <agent>` subcommands defined in
-# unsloth_cli/commands/start.py. Each entry is the exact executable name that
-# subcommand launches, so a hit here means `unsloth start <agent>` can find the
-# binary on PATH without the user installing anything first.
+# unsloth_cli/commands/start.py, in the order the Settings pickers list them. Each
+# entry is the executable that subcommand needs on PATH (see _EXECUTABLES).
CODING_AGENTS: tuple[str, ...] = (
"claude",
"codex",
- "openclaw",
+ "vscode",
+ "dsh",
"opencode",
"hermes",
+ "openclaw",
"pi",
- "dsh",
"vibe",
)
+# `unsloth start vscode` edits VS Code's settings; `code` is the launcher an install puts on PATH.
+_EXECUTABLES = {"vscode": "code"}
+
def is_deepseek_harness_executable(executable: str, *, allow_execution: bool = True) -> bool:
"""Return whether ``executable`` identifies itself as DeepSeek Harness."""
@@ -93,7 +96,7 @@ def _is_on_path(agent: str) -> bool:
# shutil.which returns None on a miss but PATH lookups can still raise, and this is advisory, so a lookup failure
# reads as "not installed" rather than breaking the endpoint.
try:
- executable = shutil.which(agent)
+ executable = shutil.which(_EXECUTABLES.get(agent, agent))
if executable is None:
return False
if agent == "dsh":
diff --git a/studio/frontend/public/agent-logos/pi-dark.svg b/studio/frontend/public/agent-logos/pi-dark.svg
new file mode 100644
index 00000000000..d5b13d573fd
--- /dev/null
+++ b/studio/frontend/public/agent-logos/pi-dark.svg
@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="-60 -60 680 680">
+ <path fill="#f6f6f6" d="M420 280H280V140H0V0H420V280Z"/>
+ <path fill="#f6f6f6" d="M560 560H420V280H560V560Z"/>
+ <path fill="#f6f6f6" d="M140 560H0V140H140V280H280V420H140V560Z"/>
+</svg>
diff --git a/studio/frontend/public/agent-logos/pi-light.svg b/studio/frontend/public/agent-logos/pi-light.svg
new file mode 100644
index 00000000000..a3e1a235384
--- /dev/null
+++ b/studio/frontend/public/agent-logos/pi-light.svg
@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="-60 -60 680 680">
+ <path fill="#111111" d="M420 280H280V140H0V0H420V280Z"/>
+ <path fill="#111111" d="M560 560H420V280H560V560Z"/>
+ <path fill="#111111" d="M140 560H0V140H140V280H280V420H140V560Z"/>
+</svg>
diff --git a/studio/frontend/public/agent-logos/vscode.svg b/studio/frontend/public/agent-logos/vscode.svg
new file mode 100644
index 00000000000..c453e633f34
--- /dev/null
+++ b/studio/frontend/public/agent-logos/vscode.svg
@@ -0,0 +1,41 @@
+<svg width="100" height="100" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg">
+<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="100">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M70.9119 99.3171C72.4869 99.9307 74.2828 99.8914 75.8725 99.1264L96.4608 89.2197C98.6242 88.1787 100 85.9892 100 83.5872V16.4133C100 14.0113 98.6243 11.8218 96.4609 10.7808L75.8725 0.873756C73.7862 -0.130129 71.3446 0.11576 69.5135 1.44695C69.252 1.63711 69.0028 1.84943 68.769 2.08341L29.3551 38.0415L12.1872 25.0096C10.589 23.7965 8.35363 23.8959 6.86933 25.2461L1.36303 30.2549C-0.452552 31.9064 -0.454633 34.7627 1.35853 36.417L16.2471 50.0001L1.35853 63.5832C-0.454633 65.2374 -0.452552 68.0938 1.36303 69.7453L6.86933 74.7541C8.35363 76.1043 10.589 76.2037 12.1872 74.9905L29.3551 61.9587L68.769 97.9167C69.3925 98.5406 70.1246 99.0104 70.9119 99.3171ZM75.0152 27.2989L45.1091 50.0001L75.0152 72.7012V27.2989Z" fill="white"/>
+</mask>
+<g mask="url(#mask0)">
+<path d="M96.4614 10.7962L75.8569 0.875542C73.4719 -0.272773 70.6217 0.211611 68.75 2.08333L1.29858 63.5832C-0.515693 65.2373 -0.513607 68.0937 1.30308 69.7452L6.81272 74.754C8.29793 76.1042 10.5347 76.2036 12.1338 74.9905L93.3609 13.3699C96.086 11.3026 100 13.2462 100 16.6667V16.4275C100 14.0265 98.6246 11.8378 96.4614 10.7962Z" fill="#0065A9"/>
+<g filter="url(#filter0_d)">
+<path d="M96.4614 89.2038L75.8569 99.1245C73.4719 100.273 70.6217 99.7884 68.75 97.9167L1.29858 36.4169C-0.515693 34.7627 -0.513607 31.9063 1.30308 30.2548L6.81272 25.246C8.29793 23.8958 10.5347 23.7964 12.1338 25.0095L93.3609 86.6301C96.086 88.6974 100 86.7538 100 83.3334V83.5726C100 85.9735 98.6246 88.1622 96.4614 89.2038Z" fill="#007ACC"/>
+</g>
+<g filter="url(#filter1_d)">
+<path d="M75.8578 99.1263C73.4721 100.274 70.6219 99.7885 68.75 97.9166C71.0564 100.223 75 98.5895 75 95.3278V4.67213C75 1.41039 71.0564 -0.223106 68.75 2.08329C70.6219 0.211402 73.4721 -0.273666 75.8578 0.873633L96.4587 10.7807C98.6234 11.8217 100 14.0112 100 16.4132V83.5871C100 85.9891 98.6234 88.1786 96.4586 89.2196L75.8578 99.1263Z" fill="#1F9CF0"/>
+</g>
+<g style="mix-blend-mode:overlay" opacity="0.25">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M70.8511 99.3171C72.4261 99.9306 74.2221 99.8913 75.8117 99.1264L96.4 89.2197C98.5634 88.1787 99.9392 85.9892 99.9392 83.5871V16.4133C99.9392 14.0112 98.5635 11.8217 96.4001 10.7807L75.8117 0.873695C73.7255 -0.13019 71.2838 0.115699 69.4527 1.44688C69.1912 1.63705 68.942 1.84937 68.7082 2.08335L29.2943 38.0414L12.1264 25.0096C10.5283 23.7964 8.29285 23.8959 6.80855 25.246L1.30225 30.2548C-0.513334 31.9064 -0.515415 34.7627 1.29775 36.4169L16.1863 50L1.29775 63.5832C-0.515415 65.2374 -0.513334 68.0937 1.30225 69.7452L6.80855 74.754C8.29285 76.1042 10.5283 76.2036 12.1264 74.9905L29.2943 61.9586L68.7082 97.9167C69.3317 98.5405 70.0638 99.0104 70.8511 99.3171ZM74.9544 27.2989L45.0483 50L74.9544 72.7012V27.2989Z" fill="url(#paint0_linear)"/>
+</g>
+</g>
+<defs>
+<filter id="filter0_d" x="-8.39411" y="15.8291" width="116.727" height="92.2456" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="4.16667"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+<filter id="filter1_d" x="60.4167" y="-8.07558" width="47.9167" height="116.151" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
+<feOffset/>
+<feGaussianBlur stdDeviation="4.16667"/>
+<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
+<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+</filter>
+<linearGradient id="paint0_linear" x1="49.9392" y1="0.257812" x2="49.9392" y2="99.7423" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+</defs>
+</svg>
diff --git a/studio/frontend/src/features/settings/api/coding-agents.ts b/studio/frontend/src/features/settings/api/coding-agents.ts
index 9fae9250fbe..891af398f54 100644
--- a/studio/frontend/src/features/settings/api/coding-agents.ts
+++ b/studio/frontend/src/features/settings/api/coding-agents.ts
@@ -16,10 +16,6 @@ type ApiCodingAgentsInfo = {
detected: string[];
};
-// Agents the CLI still supports but Unsloth does not list. Filtered here so
-// every consumer of this endpoint sees the same set.
-const HIDDEN_AGENTS = new Set(["pi"]);
-
// Which CLIs are on PATH is environment state, not a persisted setting -- it can change any time
// the user installs something new, so this only de-duplicates concurrent in-flight calls (e.g.
// React strict-mode's double mount) rather than caching the result across the module's lifetime.
@@ -27,8 +23,7 @@ const HIDDEN_AGENTS = new Set(["pi"]);
let inFlightInfo: Promise<CodingAgentsInfo> | null = null;
function fromApi(info: ApiCodingAgentsInfo): CodingAgentsInfo {
- const visible = (ids: string[]) => ids.filter((id) => !HIDDEN_AGENTS.has(id));
- return { agents: visible(info.agents), detected: visible(info.detected) };
+ return { agents: info.agents, detected: info.detected };
}
async function fetchCodingAgents(): Promise<CodingAgentsInfo> {
diff --git a/studio/frontend/src/features/settings/components/agent-command-block.tsx b/studio/frontend/src/features/settings/components/agent-command-block.tsx
index c5c22222e68..ba6fc8a9528 100644
--- a/studio/frontend/src/features/settings/components/agent-command-block.tsx
+++ b/studio/frontend/src/features/settings/components/agent-command-block.tsx
@@ -55,17 +55,20 @@ export function AgentIcon({
darkIcon,
color,
mark,
+ compact = false,
}: {
logo?: string;
icon?: string;
darkIcon?: string;
color?: string;
mark?: string;
+ compact?: boolean;
}) {
+ const markSize = compact ? "size-4" : "size-5";
if (logo) {
return (
<span className="flex size-5 shrink-0 items-center justify-center overflow-hidden rounded">
- <ApiProviderLogo providerType={logo} className="size-5 rounded" />
+ <ApiProviderLogo providerType={logo} className={cn(markSize, "rounded")} />
</span>
);
}
@@ -80,14 +83,14 @@ export function AgentIcon({
src={iconSrc}
alt=""
aria-hidden={true}
- className={cn("size-5 object-contain", darkIconSrc && "dark:hidden")}
+ className={cn(markSize, "object-contain", darkIconSrc && "dark:hidden")}
/>
{darkIconSrc ? (
<img
src={darkIconSrc}
alt=""
aria-hidden={true}
- className="hidden size-5 object-contain dark:block"
+ className={cn("hidden object-contain dark:block", markSize)}
/>
) : null}
</span>
diff --git a/studio/frontend/src/features/settings/components/agent-command.ts b/studio/frontend/src/features/settings/components/agent-command.ts
index 83564b9ce89..b36757952a5 100644
--- a/studio/frontend/src/features/settings/components/agent-command.ts
+++ b/studio/frontend/src/features/settings/components/agent-command.ts
@@ -7,6 +7,8 @@
// the default local server. For a non-default port or tunnel/remote base, emit the
// URL (plus a key for non-loopback) so the copy targets what the UI shows.
+import { NOT_AUTO_PICKED_AGENTS } from "./coding-agent-list.ts";
+
const DEFAULT_STUDIO_PORT = "8888";
const DEFAULT_AGENT = "claude";
const SAFE_SHELL_ARG_PATTERN = /^[A-Za-z0-9_./:@%+=,-]+$/;
@@ -167,8 +169,10 @@ export function pickCompatibleAgent(
isGguf: boolean,
offered: readonly string[] = [],
): string | null {
- const preferred = detectedAgents.find((agent) =>
- agentRunsOnActiveModel(agent, isGguf),
+ const preferred = detectedAgents.find(
+ (agent) =>
+ !NOT_AUTO_PICKED_AGENTS.has(agent) &&
+ agentRunsOnActiveModel(agent, isGguf),
);
if (preferred) {
return preferred;
diff --git a/studio/frontend/src/features/settings/components/coding-agent-list.ts b/studio/frontend/src/features/settings/components/coding-agent-list.ts
index 3f657962c22..ed425443719 100644
--- a/studio/frontend/src/features/settings/components/coding-agent-list.ts
+++ b/studio/frontend/src/features/settings/components/coding-agent-list.ts
@@ -15,6 +15,8 @@ export type AgentDetails = {
darkIcon?: string;
color?: string;
mark?: string;
+ /** Draw the mark at 16px in the 20px slot, for marks that fill their whole box. */
+ compact?: boolean;
};
// names stay untranslated; `settings.agents.intro` includes them for search.
@@ -31,6 +33,29 @@ export const SUPPORTED_AGENTS: AgentDetails[] = [
docsUrl: "https://unsloth.ai/docs/basics/codex",
logo: "openai",
},
+ {
+ id: "vscode",
+ name: "VS Code",
+ docsUrl:
+ "https://code.visualstudio.com/docs/copilot/customization/language-models",
+ // vscode.svg is the stable icon from code.visualstudio.com/brand.
+ icon: "vscode.svg",
+ compact: true,
+ },
+ {
+ id: "dsh",
+ name: "DeepSeek Harness",
+ docsUrl: "https://github.com/deepseek-ai/deepseek-harness",
+ logo: "deepseek",
+ },
+ {
+ id: "opencode",
+ name: "OpenCode",
+ docsUrl: "https://unsloth.ai/docs/integrations/opencode",
+ icon: "opencode-light.svg",
+ darkIcon: "opencode-dark.svg",
+ compact: true,
+ },
{
id: "hermes",
name: "Hermes Agent",
@@ -45,26 +70,26 @@ export const SUPPORTED_AGENTS: AgentDetails[] = [
icon: "openclaw.svg",
},
{
- id: "opencode",
- name: "OpenCode",
- docsUrl: "https://unsloth.ai/docs/integrations/opencode",
- icon: "opencode-light.svg",
- darkIcon: "opencode-dark.svg",
- },
- {
- id: "dsh",
- name: "DeepSeek Harness",
- docsUrl: "https://github.com/deepseek-ai/deepseek-harness",
- logo: "deepseek",
+ id: "pi",
+ name: "Pi",
+ docsUrl: "https://pi.dev",
+ // The monochrome mark from https://pi.dev/favicon.svg, in its light and dark fills.
+ icon: "pi-light.svg",
+ darkIcon: "pi-dark.svg",
+ compact: true,
},
{
id: "vibe",
name: "Mistral Vibe",
docsUrl: "https://github.com/mistralai/mistral-vibe",
logo: "mistral",
+ compact: true,
},
];
+// Most developers have `code` on PATH, and VS Code is not a terminal agent: offered, never auto-picked.
+export const NOT_AUTO_PICKED_AGENTS: ReadonlySet<string> = new Set(["vscode"]);
+
export function detailsFor(agentId: string): AgentDetails {
return (
SUPPORTED_AGENTS.find((agent) => agent.id === agentId) ?? {
diff --git a/studio/frontend/src/features/settings/components/mcp-access-section.tsx b/studio/frontend/src/features/settings/components/mcp-access-section.tsx
index 33986aca276..57e22aaa1f4 100644
--- a/studio/frontend/src/features/settings/components/mcp-access-section.tsx
+++ b/studio/frontend/src/features/settings/components/mcp-access-section.tsx
@@ -35,6 +35,7 @@ import {
MCP_API_KEY_ENV,
MCP_SHELL_AGENT_IDS,
buildMcpSnippet,
+ hasMcpSnippet,
} from "./mcp-agent-snippet";
import { SettingsRow } from "./settings-row";
import {
@@ -43,6 +44,7 @@ import {
} from "./tunnel-preference";
const ENV_FORCE = "UNSLOTH_STUDIO_ENABLE_MCP";
+const MCP_AGENTS = SUPPORTED_AGENTS.filter((agent) => hasMcpSnippet(agent.id));
const OS_OPTIONS = [
{ os: "unix", labelKey: "settings.apiKeys.osUnix" },
{ os: "windows", labelKey: "settings.apiKeys.osWindows" },
@@ -71,9 +73,9 @@ export function McpAccessSection({
const setStoredOs = useSettingsPanelPrefsStore((s) => s.setMcpOs);
const agent =
- storedAgent && SUPPORTED_AGENTS.some((a) => a.id === storedAgent)
+ storedAgent && MCP_AGENTS.some((a) => a.id === storedAgent)
? storedAgent
- : SUPPORTED_AGENTS[0].id;
+ : MCP_AGENTS[0].id;
// an explicit pick wins, since the agent may run on another machine.
const os: ExampleOs =
storedOs ?? (deviceType === "windows" ? "windows" : "unix");
@@ -197,7 +199,7 @@ export function McpAccessSection({
</SelectValue>
</SelectTrigger>
<SelectContent align="end">
- {SUPPORTED_AGENTS.map((option) => (
+ {MCP_AGENTS.map((option) => (
<SelectItem key={option.id} value={option.id}>
<span className="flex min-w-0 items-center gap-2">
<AgentIcon {...option} />
diff --git a/studio/frontend/src/features/settings/components/mcp-agent-snippet.ts b/studio/frontend/src/features/settings/components/mcp-agent-snippet.ts
index 1f315c577a2..14ca8972cb2 100644
--- a/studio/frontend/src/features/settings/components/mcp-agent-snippet.ts
+++ b/studio/frontend/src/features/settings/components/mcp-agent-snippet.ts
@@ -169,6 +169,10 @@ const CONFIG_PATHS: Record<string, string> = {
// these read the key from UNSLOTH_API_KEY even when the caller passes one.
const ENV_ONLY_AGENT_IDS: ReadonlySet<string> = new Set(["codex", "vibe"]);
+export function hasMcpSnippet(agentId: string): boolean {
+ return BUILDERS.has(agentId);
+}
+
/** returns setup for a known agent and valid base URL, with a literal key only when provided. */
export function buildMcpSnippet(
agentId: string,
diff --git a/studio/frontend/src/features/settings/components/usage-examples.tsx b/studio/frontend/src/features/settings/components/usage-examples.tsx
index dbcfeaae6df..d6482ffb6ab 100644
--- a/studio/frontend/src/features/settings/components/usage-examples.tsx
+++ b/studio/frontend/src/features/settings/components/usage-examples.tsx
@@ -132,28 +132,35 @@ const ADV = {
const DOC_LINKS = [
{ label: "Claude Code", href: "https://unsloth.ai/docs/basics/claude-code" },
{ label: "Codex", href: "https://unsloth.ai/docs/basics/codex" },
- { label: "OpenClaw", href: "https://unsloth.ai/docs/integrations/openclaw" },
- { label: "OpenCode", href: "https://unsloth.ai/docs/integrations/opencode" },
{
- label: "Hermes Agent",
- href: "https://unsloth.ai/docs/integrations/hermes-agent",
+ label: "VS Code",
+ href: "https://code.visualstudio.com/docs/copilot/customization/language-models",
},
{
label: "DeepSeek Harness",
href: "https://github.com/deepseek-ai/deepseek-harness",
},
+ { label: "OpenCode", href: "https://unsloth.ai/docs/integrations/opencode" },
+ {
+ label: "Hermes Agent",
+ href: "https://unsloth.ai/docs/integrations/hermes-agent",
+ },
+ { label: "OpenClaw", href: "https://unsloth.ai/docs/integrations/openclaw" },
+ { label: "Pi", href: "https://pi.dev" },
{ label: "Mistral Vibe", href: "https://github.com/mistralai/mistral-vibe" },
];
// Fallback until the backend's installed-CLI check resolves. Mirrors CODING_AGENTS in
-// studio/backend/utils/coding_agents.py, minus HIDDEN_AGENTS (see ../api/coding-agents.ts).
+// studio/backend/utils/coding_agents.py.
const DEFAULT_AGENTS = [
"claude",
"codex",
- "openclaw",
+ "vscode",
+ "dsh",
"opencode",
"hermes",
- "dsh",
+ "openclaw",
+ "pi",
"vibe",
];
// The agent selection resets to this whenever an auto-pick is no longer
@@ -163,10 +170,12 @@ const DEFAULT_AGENT = "claude";
const AGENT_LABELS: Record<string, string> = {
claude: "Claude Code",
codex: "Codex",
- openclaw: "OpenClaw",
+ vscode: "VS Code",
+ dsh: "DeepSeek Harness",
opencode: "OpenCode",
hermes: "Hermes",
- dsh: "DeepSeek Harness",
+ openclaw: "OpenClaw",
+ pi: "Pi",
vibe: "Mistral Vibe",
};
@@ -1073,6 +1082,11 @@ export function UsageExamples({
/>
</button>
</div>
+ {agent === "vscode" && (
+ <span className="text-ui-11 leading-snug text-muted-foreground">
+ {t("settings.agents.vscodeNote")}
+ </span>
+ )}
<span className="text-ui-11 leading-snug text-muted-foreground">
{detectedAgents.length > 0
? t("settings.apiKeys.codingAgentsDetectedHint", {
diff --git a/studio/frontend/src/features/settings/settings-search.ts b/studio/frontend/src/features/settings/settings-search.ts
index 8e39ab96134..c2f12703d57 100644
--- a/studio/frontend/src/features/settings/settings-search.ts
+++ b/studio/frontend/src/features/settings/settings-search.ts
@@ -438,4 +438,6 @@ export const SETTINGS_SEARCH_KEYWORDS: Partial<
"settings.chat.scrollToBottomButton": "settings.chat.scrollToBottomButtonKeywords",
// match protocol and agent names omitted from the title.
"settings.apiKeys.mcp.title": "settings.apiKeys.mcp.keywords",
+ // the intro names only some agents; every listed one has to find this page.
+ "settings.agents.agent": "settings.agents.agentKeywords",
};
diff --git a/studio/frontend/src/features/settings/tabs/agents-tab.tsx b/studio/frontend/src/features/settings/tabs/agents-tab.tsx
index 9b929aa4524..a173618d619 100644
--- a/studio/frontend/src/features/settings/tabs/agents-tab.tsx
+++ b/studio/frontend/src/features/settings/tabs/agents-tab.tsx
@@ -65,6 +65,7 @@ import {
} from "../components/agent-command-block";
import {
type AgentDetails,
+ NOT_AUTO_PICKED_AGENTS,
SUPPORTED_AGENTS,
UNSLOTH_START_DOCS_URL,
detailsFor,
@@ -89,7 +90,7 @@ const MODEL_RESULT_LIMIT = 7;
const STATUS_POLL_MS = 5000;
const HUGGING_FACE_REPO_PATTERN = /^[^/\\:\s]+\/[^/\\:\s]+$/;
const SEARCH_TOKEN_PATTERN = /\s+/;
-const SUBAGENT_AGENT_IDS = new Set(["claude", "codex", "opencode"]);
+const SUBAGENT_AGENT_IDS = new Set(["claude", "codex", "opencode", "pi"]);
function isLoopbackBase(base: string): boolean {
try {
@@ -693,8 +694,10 @@ export function AgentsTab() {
if (agentSelectionChanged.current) {
return current;
}
- const detected = next.detected.find((agent) =>
- next.agents.includes(agent),
+ const detected = next.detected.find(
+ (agent) =>
+ next.agents.includes(agent) &&
+ !NOT_AUTO_PICKED_AGENTS.has(agent),
);
return (
detected ??
@@ -725,7 +728,10 @@ export function AgentsTab() {
agentSelectionChanged.current = false;
setStoredAgent(null);
setSelectedAgent(
- agents.find((agent) => detectedAgents.has(agent)) ??
+ agents.find(
+ (agent) =>
+ detectedAgents.has(agent) && !NOT_AUTO_PICKED_AGENTS.has(agent),
+ ) ??
agents[0] ??
FALLBACK_AGENT.id,
);
@@ -1224,6 +1230,7 @@ export function AgentsTab() {
darkIcon={selectedAgentDetails.darkIcon}
color={selectedAgentDetails.color}
mark={selectedAgentDetails.mark}
+ compact={selectedAgentDetails.compact}
/>
<span className="truncate">
{selectedAgentDetails.name}
@@ -1231,7 +1238,11 @@ export function AgentsTab() {
</span>
</SelectValue>
</SelectTrigger>
- <SelectContent align="start">
+ {/* Seven 36px rows plus the 4px surface padding. */}
+ <SelectContent
+ align="start"
+ className="max-h-[min(var(--radix-select-content-available-height),calc(7*2.25rem+0.5rem))] [&_[data-slot=select-scroll-down-button]]:hidden [&_[data-slot=select-scroll-up-button]]:hidden"
+ >
{agents.map((agentId) => {
const agent = detailsFor(agentId);
return (
@@ -1243,6 +1254,7 @@ export function AgentsTab() {
darkIcon={agent.darkIcon}
color={agent.color}
mark={agent.mark}
+ compact={agent.compact}
/>
<span className="truncate">{agent.name}</span>
{localDetection &&
@@ -1460,6 +1472,11 @@ export function AgentsTab() {
copied={copied}
onCopy={handleCopy}
/>
+ {selectedAgent === "vscode" && (
+ <p className="text-ui-11 leading-relaxed text-muted-foreground">
+ {t("settings.agents.vscodeNote")}
+ </p>
+ )}
<p className="text-ui-11 leading-relaxed text-muted-foreground">
{t("settings.agents.configurationNote")}{" "}
<a
diff --git a/studio/frontend/src/i18n/locales/ar.ts b/studio/frontend/src/i18n/locales/ar.ts
index 0623ce37e7d..128066044e2 100644
--- a/studio/frontend/src/i18n/locales/ar.ts
+++ b/studio/frontend/src/i18n/locales/ar.ts
@@ -2398,8 +2398,11 @@ export const ar = {
title: "الوكلاء",
description:
"اربط وكلاء البرمجة مثل Claude Code وCodex بنموذج محلي باستخدام unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "يُستثنى VS Code: يضيف هذا الأمر النموذج المقدَّم إلى قائمة نماذج Copilot Chat في VS Code (chatLanguageModels.json).",
intro:
- "يربط Claude Code وCodex وDeepSeek Harness وHermes وMistral Vibe وOpenClaw وOpenCode وغيرها من الوكلاء بنموذج يقدّمه Unsloth محليًا، دون اتصال بالإنترنت تمامًا. يشغّل خادمًا متوافقًا مع OpenAI ولا يمسّ ملفات إعدادات وكيلك إطلاقًا.",
+ "يربط Claude Code وCodex وDeepSeek Harness وHermes وOpenClaw وOpenCode وغيرها من الوكلاء بنموذج يقدّمه Unsloth محليًا، دون اتصال بالإنترنت تمامًا. يشغّل خادمًا متوافقًا مع OpenAI ولا يمسّ ملفات إعدادات وكيلك إطلاقًا.",
readDocs: "قراءة التوثيق",
copy: "نسخ",
copied: "تم النسخ",
@@ -2479,7 +2482,7 @@ export const ar = {
launch: "يشغّل الوكيل، أو يكتفي بطباعة الأمر والبيئة.",
persist: "يحتفظ بمساحة تخزين الوكيل التي يديرها Unsloth بين عمليات التشغيل.",
asSubagent:
- "يبقي الوكيل الأصلي على نموذجه الحالي ويسجّل Unsloth كوكيل فرعي محلي (Claude Code وCodex وOpenCode).",
+ "يبقي الوكيل الأصلي على نموذجه الحالي ويسجّل Unsloth كوكيل فرعي محلي (Claude Code وCodex وOpenCode وPi).",
apiKey: "يمرّر مفتاح API الخاص بـ Unsloth (أو اضبط UNSLOTH_API_KEY).",
reasoning:
"استخدام الاستدلال في المحادثة: on أو off أو auto. ويتبع auto قالب المحادثة الخاص بالنموذج، وهو غالبًا on.",
diff --git a/studio/frontend/src/i18n/locales/de.ts b/studio/frontend/src/i18n/locales/de.ts
index ac38587b0a7..cb7f7c84181 100644
--- a/studio/frontend/src/i18n/locales/de.ts
+++ b/studio/frontend/src/i18n/locales/de.ts
@@ -2429,8 +2429,11 @@ export const de = {
title: "Agenten",
description:
"Verbinden Sie Coding-Agenten wie Claude Code und Codex über unsloth start mit einem lokalen Modell.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code ist die Ausnahme: Dieser Befehl fügt das bereitgestellte Modell der Copilot-Chat-Modellliste von VS Code hinzu (chatLanguageModels.json).",
intro:
- "verbindet Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode und weitere Agenten mit einem lokal von Unsloth bereitgestellten Modell, vollständig offline. Es startet einen OpenAI-kompatiblen Server und verändert nie die Konfigurationsdateien Ihres Agenten.",
+ "verbindet Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode und weitere Agenten mit einem lokal von Unsloth bereitgestellten Modell, vollständig offline. Es startet einen OpenAI-kompatiblen Server und verändert nie die Konfigurationsdateien Ihres Agenten.",
readDocs: "Dokumentation lesen",
copy: "Kopieren",
copied: "Kopiert",
@@ -2515,7 +2518,7 @@ export const de = {
persist:
"Behält die von Unsloth verwalteten Agent-Daten über Läufe hinweg bei.",
asSubagent:
- "Belässt den übergeordneten Agenten bei seinem aktuellen Modell und registriert Unsloth als lokalen Subagenten (Claude Code, Codex und OpenCode).",
+ "Belässt den übergeordneten Agenten bei seinem aktuellen Modell und registriert Unsloth als lokalen Subagenten (Claude Code, Codex, OpenCode und Pi).",
apiKey:
"Übergibt Ihren Unsloth-API-Schlüssel (alternativ UNSLOTH_API_KEY setzen).",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/en.ts b/studio/frontend/src/i18n/locales/en.ts
index 421585d45db..3a760fb037f 100644
--- a/studio/frontend/src/i18n/locales/en.ts
+++ b/studio/frontend/src/i18n/locales/en.ts
@@ -2442,8 +2442,11 @@ export const en = {
title: "Agents",
description:
"Connect coding agents like Claude Code and Codex to a local model with unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code is the exception: this command adds the served model to VS Code's Copilot Chat model list (chatLanguageModels.json).",
intro:
- "connects Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode and other agents to a model served locally by Unsloth, fully offline. It runs an OpenAI-compatible server and never touches your agent's config files.",
+ "connects Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode and other agents to a model served locally by Unsloth, fully offline. It runs an OpenAI-compatible server and never touches your agent's config files.",
readDocs: "Read the docs",
copy: "Copy",
copied: "Copied",
@@ -2520,7 +2523,7 @@ export const en = {
launch: "Launch the agent, or just print the command and environment.",
persist: "Keep Unsloth-managed agent storage between runs.",
asSubagent:
- "Keep the parent on its current model and register Unsloth as a local subagent (Claude Code, Codex, and OpenCode).",
+ "Keep the parent on its current model and register Unsloth as a local subagent (Claude Code, Codex, OpenCode, and Pi).",
apiKey: "Provide your Unsloth API key (or set UNSLOTH_API_KEY).",
reasoning:
"Use reasoning in the chat: on, off, or auto. Auto follows the model's chat template, which usually means on.",
diff --git a/studio/frontend/src/i18n/locales/es.ts b/studio/frontend/src/i18n/locales/es.ts
index a6ab0d9607d..e37a282fa50 100644
--- a/studio/frontend/src/i18n/locales/es.ts
+++ b/studio/frontend/src/i18n/locales/es.ts
@@ -2423,8 +2423,11 @@ export const es = {
title: "Agentes",
description:
"Conecta agentes de programación como Claude Code y Codex a un modelo local con unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code es la excepción: este comando añade el modelo servido a la lista de modelos de Copilot Chat de VS Code (chatLanguageModels.json).",
intro:
- "conecta Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode y otros agentes a un modelo servido localmente por Unsloth, totalmente sin conexión. Ejecuta un servidor compatible con OpenAI y nunca modifica los archivos de configuración de tu agente.",
+ "conecta Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode y otros agentes a un modelo servido localmente por Unsloth, totalmente sin conexión. Ejecuta un servidor compatible con OpenAI y nunca modifica los archivos de configuración de tu agente.",
readDocs: "Leer la documentación",
copy: "Copiar",
copied: "Copiado",
@@ -2507,7 +2510,7 @@ export const es = {
persist:
"Conserva entre ejecuciones el almacenamiento de agentes que gestiona Unsloth.",
asSubagent:
- "Mantén el agente principal en su modelo actual y registra Unsloth como subagente local (Claude Code, Codex y OpenCode).",
+ "Mantén el agente principal en su modelo actual y registra Unsloth como subagente local (Claude Code, Codex, OpenCode y Pi).",
apiKey: "Indica tu clave de API de Unsloth (o define UNSLOTH_API_KEY).",
reasoning:
"Usar razonamiento en el chat: on, off o auto. Auto sigue la plantilla de chat del modelo, lo que suele significar on.",
diff --git a/studio/frontend/src/i18n/locales/fr.ts b/studio/frontend/src/i18n/locales/fr.ts
index 9e73a65373f..de2416abfb6 100644
--- a/studio/frontend/src/i18n/locales/fr.ts
+++ b/studio/frontend/src/i18n/locales/fr.ts
@@ -2427,8 +2427,11 @@ export const fr = {
title: "Agents",
description:
"Connectez des agents de codage comme Claude Code et Codex à un modèle local avec unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code fait exception : cette commande ajoute le modèle servi à la liste des modèles de Copilot Chat dans VS Code (chatLanguageModels.json).",
intro:
- "connecte Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode et d'autres agents à un modèle servi localement par Unsloth, entièrement hors ligne. Il lance un serveur compatible OpenAI et ne touche jamais aux fichiers de configuration de votre agent.",
+ "connecte Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode et d'autres agents à un modèle servi localement par Unsloth, entièrement hors ligne. Il lance un serveur compatible OpenAI et ne touche jamais aux fichiers de configuration de votre agent.",
readDocs: "Lire la documentation",
copy: "Copier",
copied: "Copié",
@@ -2512,7 +2515,7 @@ export const fr = {
persist:
"Conserve d'une exécution à l'autre les données d'agent gérées par Unsloth.",
asSubagent:
- "Garde l'agent parent sur son modèle actuel et enregistre Unsloth comme sous-agent local (Claude Code, Codex et OpenCode).",
+ "Garde l'agent parent sur son modèle actuel et enregistre Unsloth comme sous-agent local (Claude Code, Codex, OpenCode et Pi).",
apiKey:
"Fournit votre clé API Unsloth, ou lit la variable UNSLOTH_API_KEY.",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/he.ts b/studio/frontend/src/i18n/locales/he.ts
index 12d58d70da0..74165f7408c 100644
--- a/studio/frontend/src/i18n/locales/he.ts
+++ b/studio/frontend/src/i18n/locales/he.ts
@@ -2494,8 +2494,11 @@ export const he = {
title: "סוכנים",
description:
"חבר סוכני תכנות כגון Claude Code ו-Codex למודל מקומי באמצעות unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code הוא היוצא מן הכלל: הפקודה מוסיפה את המודל המוגש לרשימת המודלים של Copilot Chat ב-VS Code (chatLanguageModels.json).",
intro:
- "מחבר את Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode וסוכנים נוספים למודל המוגש מקומית על ידי Unsloth, במצב לא מקוון לחלוטין. הוא מפעיל שרת תואם OpenAI ולעולם אינו נוגע בקובצי ההגדרות של הסוכן שלך.",
+ "מחבר את Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode וסוכנים נוספים למודל המוגש מקומית על ידי Unsloth, במצב לא מקוון לחלוטין. הוא מפעיל שרת תואם OpenAI ולעולם אינו נוגע בקובצי ההגדרות של הסוכן שלך.",
readDocs: "קרא את התיעוד",
copy: "העתק",
copied: "הועתק",
@@ -2573,7 +2576,7 @@ export const he = {
launch: "הפעל את הסוכן, או הדפס רק את הפקודה ומשתני הסביבה.",
persist: "שמור את אחסון הסוכן המנוהל על ידי Unsloth בין הרצות.",
asSubagent:
- "השאר את סוכן האב במודל הנוכחי שלו ורשום את Unsloth כתת-סוכן מקומי (Claude Code, Codex, ו-OpenCode).",
+ "השאר את סוכן האב במודל הנוכחי שלו ורשום את Unsloth כתת-סוכן מקומי (Claude Code, Codex, OpenCode ו-Pi).",
apiKey: "ספק את מפתח ה-API של Unsloth (או הגדר את UNSLOTH_API_KEY).",
reasoning:
"השתמש בחשיבה (Reasoning) בצ'אט: on, off, או auto. המצב auto פועל לפי תבנית הצ'אט של המודל, שלרוב מפעילה חשיבה.",
diff --git a/studio/frontend/src/i18n/locales/hi.ts b/studio/frontend/src/i18n/locales/hi.ts
index 8c89d2f8dd5..84a0f6afb5f 100644
--- a/studio/frontend/src/i18n/locales/hi.ts
+++ b/studio/frontend/src/i18n/locales/hi.ts
@@ -2401,8 +2401,11 @@ export const hi = {
title: "एजेंट",
description:
"unsloth start की मदद से Claude Code और Codex जैसे कोडिंग एजेंट को लोकल मॉडल से जोड़ें।",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code अपवाद है: यह कमांड परोसे जा रहे मॉडल को VS Code की Copilot Chat मॉडल सूची (chatLanguageModels.json) में जोड़ती है।",
intro:
- "Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode और दूसरे एजेंट को Unsloth द्वारा लोकली सर्व किए गए मॉडल से जोड़ता है, पूरी तरह ऑफ़लाइन। यह एक OpenAI-संगत सर्वर चलाता है और आपके एजेंट की कॉन्फ़िगरेशन फ़ाइलों को कभी नहीं छूता।",
+ "Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode और दूसरे एजेंट को Unsloth द्वारा लोकली सर्व किए गए मॉडल से जोड़ता है, पूरी तरह ऑफ़लाइन। यह एक OpenAI-संगत सर्वर चलाता है और आपके एजेंट की कॉन्फ़िगरेशन फ़ाइलों को कभी नहीं छूता।",
readDocs: "दस्तावेज़ पढ़ें",
copy: "कॉपी करें",
copied: "कॉपी किया गया",
@@ -2483,7 +2486,7 @@ export const hi = {
persist:
"Unsloth द्वारा प्रबंधित एजेंट स्टोरेज को रनों के बीच बनाए रखता है।",
asSubagent:
- "मूल एजेंट को उसके मौजूदा मॉडल पर रखता है और Unsloth को लोकल सबएजेंट के रूप में दर्ज करता है (Claude Code, Codex और OpenCode)।",
+ "मूल एजेंट को उसके मौजूदा मॉडल पर रखता है और Unsloth को लोकल सबएजेंट के रूप में दर्ज करता है (Claude Code, Codex, OpenCode और Pi)।",
apiKey:
"आपकी Unsloth API key लेता है (या UNSLOTH_API_KEY सेट करें)।",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/it.ts b/studio/frontend/src/i18n/locales/it.ts
index d9722f88877..5fa3eb5c2d8 100644
--- a/studio/frontend/src/i18n/locales/it.ts
+++ b/studio/frontend/src/i18n/locales/it.ts
@@ -2358,8 +2358,11 @@ export const it = {
title: "Agenti",
description:
"Collega agenti di programmazione come Claude Code e Codex a un modello locale con unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code fa eccezione: questo comando aggiunge il modello servito all'elenco dei modelli di Copilot Chat in VS Code (chatLanguageModels.json).",
intro:
- "collega Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode e altri agenti a un modello servito localmente da Unsloth, completamente offline. Avvia un server compatibile con le API OpenAI e non modifica i file di configurazione del tuo agente.",
+ "collega Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode e altri agenti a un modello servito localmente da Unsloth, completamente offline. Avvia un server compatibile con le API OpenAI e non modifica i file di configurazione del tuo agente.",
readDocs: "Leggi la documentazione",
copy: "Copia",
copied: "Copiato",
@@ -2443,7 +2446,7 @@ export const it = {
persist:
"Mantieni tra un'esecuzione e l'altra i dati dell'agente gestiti da Unsloth.",
asSubagent:
- "Mantieni l'agente principale sul suo modello attuale e registra Unsloth come subagente locale (Claude Code, Codex e OpenCode).",
+ "Mantieni l'agente principale sul suo modello attuale e registra Unsloth come subagente locale (Claude Code, Codex, OpenCode e Pi).",
apiKey:
"Fornisci la tua chiave API Unsloth (oppure imposta UNSLOTH_API_KEY).",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/ja.ts b/studio/frontend/src/i18n/locales/ja.ts
index 36e862ff9eb..9891a960723 100644
--- a/studio/frontend/src/i18n/locales/ja.ts
+++ b/studio/frontend/src/i18n/locales/ja.ts
@@ -2378,8 +2378,11 @@ export const ja = {
title: "エージェント",
description:
"unsloth start で Claude Code や Codex などのコーディングエージェントをローカルモデルに接続します。",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code は例外です。このコマンドは、提供中のモデルを VS Code の Copilot Chat のモデル一覧(chatLanguageModels.json)に追加します。",
intro:
- "は Claude Code、Codex、DeepSeek Harness、Hermes、Mistral Vibe、OpenClaw、OpenCode などのエージェントを、Unsloth がローカルで提供するモデルに完全オフラインで接続します。OpenAI 互換サーバーを起動し、エージェントの設定ファイルには一切手を加えません。",
+ "は Claude Code、Codex、DeepSeek Harness、Hermes、OpenClaw、OpenCode などのエージェントを、Unsloth がローカルで提供するモデルに完全オフラインで接続します。OpenAI 互換サーバーを起動し、エージェントの設定ファイルには一切手を加えません。",
readDocs: "ドキュメントを読む",
copy: "コピー",
copied: "コピーしました",
@@ -2463,7 +2466,7 @@ export const ja = {
persist:
"Unsloth が管理するエージェントのストレージを実行間で保持します。",
asSubagent:
- "親エージェントを現在のモデルのままにし、Unsloth をローカルのサブエージェントとして登録します (Claude Code、Codex、OpenCode)。",
+ "親エージェントを現在のモデルのままにし、Unsloth をローカルのサブエージェントとして登録します (Claude Code、Codex、OpenCode、Pi)。",
apiKey:
"Unsloth の API キーを指定します (または UNSLOTH_API_KEY を設定)。",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/ko.ts b/studio/frontend/src/i18n/locales/ko.ts
index f7afecc02b5..aa6b5b79ad8 100644
--- a/studio/frontend/src/i18n/locales/ko.ts
+++ b/studio/frontend/src/i18n/locales/ko.ts
@@ -2394,8 +2394,11 @@ export const ko = {
title: "에이전트",
description:
"unsloth start로 Claude Code, Codex 같은 코딩 에이전트를 로컬 모델에 연결하세요.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code는 예외입니다. 이 명령은 제공 중인 모델을 VS Code Copilot Chat 모델 목록(chatLanguageModels.json)에 추가합니다.",
intro:
- "명령어를 사용하면 Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode를 비롯한 여러 에이전트를 Unsloth가 로컬에서 실행하는 모델에 연결해 완전히 오프라인으로 사용할 수 있습니다. OpenAI 호환 서버를 실행하며, 에이전트의 설정 파일은 변경하지 않습니다.",
+ "명령어를 사용하면 Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode를 비롯한 여러 에이전트를 Unsloth가 로컬에서 실행하는 모델에 연결해 완전히 오프라인으로 사용할 수 있습니다. OpenAI 호환 서버를 실행하며, 에이전트의 설정 파일은 변경하지 않습니다.",
readDocs: "문서 보기",
copy: "복사",
copied: "복사됨",
@@ -2473,7 +2476,7 @@ export const ko = {
persist:
"Unsloth가 관리하는 에이전트 저장소를 실행 사이에 유지합니다.",
asSubagent:
- "상위 에이전트는 현재 모델을 유지하고 Unsloth를 로컬 서브에이전트로 등록합니다(Claude Code, Codex, OpenCode).",
+ "상위 에이전트는 현재 모델을 유지하고 Unsloth를 로컬 서브에이전트로 등록합니다(Claude Code, Codex, OpenCode, Pi).",
apiKey:
"Unsloth API 키를 지정합니다(또는 UNSLOTH_API_KEY 환경 변수를 설정합니다).",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/pt-br.ts b/studio/frontend/src/i18n/locales/pt-br.ts
index 9c67c9a51e8..b8b7f318f29 100644
--- a/studio/frontend/src/i18n/locales/pt-br.ts
+++ b/studio/frontend/src/i18n/locales/pt-br.ts
@@ -2411,8 +2411,11 @@ export const ptBR = {
title: "Agentes",
description:
"Conecte agentes de código como Claude Code e Codex a um modelo local com unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "O VS Code é a exceção: este comando adiciona o modelo servido à lista de modelos do Copilot Chat no VS Code (chatLanguageModels.json).",
intro:
- "conecta Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode e outros agentes a um modelo servido localmente pelo Unsloth, totalmente offline. Ele executa um servidor compatível com a API da OpenAI e nunca altera os arquivos de configuração do seu agente.",
+ "conecta Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode e outros agentes a um modelo servido localmente pelo Unsloth, totalmente offline. Ele executa um servidor compatível com a API da OpenAI e nunca altera os arquivos de configuração do seu agente.",
readDocs: "Ler a documentação",
copy: "Copiar",
copied: "Copiado",
@@ -2495,7 +2498,7 @@ export const ptBR = {
persist:
"Mantém entre execuções o armazenamento de agentes gerenciado pelo Unsloth.",
asSubagent:
- "Mantém o agente principal no modelo atual e registra o Unsloth como subagente local (Claude Code, Codex e OpenCode).",
+ "Mantém o agente principal no modelo atual e registra o Unsloth como subagente local (Claude Code, Codex, OpenCode e Pi).",
apiKey:
"Informa sua chave de API do Unsloth (ou defina UNSLOTH_API_KEY).",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/ru.ts b/studio/frontend/src/i18n/locales/ru.ts
index 9b50d2fb835..713ad93221a 100644
--- a/studio/frontend/src/i18n/locales/ru.ts
+++ b/studio/frontend/src/i18n/locales/ru.ts
@@ -2405,8 +2405,11 @@ export const ru = {
title: "Агенты",
description:
"Подключение кодинг-агентов, таких как Claude Code и Codex, к локальной модели с помощью unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code — исключение: эта команда добавляет обслуживаемую модель в список моделей Copilot Chat в VS Code (chatLanguageModels.json).",
intro:
- "подключает Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode и других агентов к модели, которую Unsloth обслуживает локально, полностью офлайн. Запускается OpenAI-совместимый сервер, а файлы конфигурации вашего агента остаются нетронутыми.",
+ "подключает Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode и других агентов к модели, которую Unsloth обслуживает локально, полностью офлайн. Запускается OpenAI-совместимый сервер, а файлы конфигурации вашего агента остаются нетронутыми.",
readDocs: "Открыть документацию",
copy: "Копировать",
copied: "Скопировано",
@@ -2490,7 +2493,7 @@ export const ru = {
persist:
"Сохраняет между запусками хранилище агента, управляемое Unsloth.",
asSubagent:
- "Оставляет родительского агента на текущей модели и регистрирует Unsloth как локального субагента (Claude Code, Codex и OpenCode).",
+ "Оставляет родительского агента на текущей модели и регистрирует Unsloth как локального субагента (Claude Code, Codex, OpenCode и Pi).",
apiKey:
"Передаёт ваш ключ API Unsloth (альтернатива: переменная UNSLOTH_API_KEY).",
reasoning:
diff --git a/studio/frontend/src/i18n/locales/sv.ts b/studio/frontend/src/i18n/locales/sv.ts
index bdf5d97354b..554451c33d7 100644
--- a/studio/frontend/src/i18n/locales/sv.ts
+++ b/studio/frontend/src/i18n/locales/sv.ts
@@ -2571,8 +2571,11 @@ export const sv = {
title: "Agenter",
description:
"Anslut kodagenter som Claude Code och Codex till en lokal modell med unsloth start.",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code är undantaget: kommandot lägger till den betjänade modellen i Copilot Chats modellista i VS Code (chatLanguageModels.json).",
intro:
- "ansluter Claude Code, Codex, DeepSeek Harness, Hermes, Mistral Vibe, OpenClaw, OpenCode och andra agenter till en modell som Unsloth kör lokalt, helt offline. Den kör en OpenAI-kompatibel server och ändrar aldrig agentens konfigurationsfiler.",
+ "ansluter Claude Code, Codex, DeepSeek Harness, Hermes, OpenClaw, OpenCode och andra agenter till en modell som Unsloth kör lokalt, helt offline. Den kör en OpenAI-kompatibel server och ändrar aldrig agentens konfigurationsfiler.",
readDocs: "Läs dokumentationen",
copy: "Kopiera",
copied: "Kopierat",
@@ -2651,7 +2654,7 @@ export const sv = {
launch: "Starta agenten eller skriv bara ut kommandot och miljön.",
persist: "Behåll Unsloth-hanterad agentlagring mellan körningar.",
asSubagent:
- "Låt föräldraagenten behålla sin nuvarande modell och registrera Unsloth som en lokal underagent (Claude Code, Codex och OpenCode).",
+ "Låt föräldraagenten behålla sin nuvarande modell och registrera Unsloth som en lokal underagent (Claude Code, Codex, OpenCode och Pi).",
apiKey: "Ange din Unsloth-API-nyckel (eller ställ in UNSLOTH_API_KEY).",
reasoning:
"Använd resonemang i chatten: på, av eller automatiskt. Automatiskt följer modellens chattmall, vilket vanligtvis innebär på.",
diff --git a/studio/frontend/src/i18n/locales/zh-CN.ts b/studio/frontend/src/i18n/locales/zh-CN.ts
index 52c6c105064..c1d5d44e9a3 100644
--- a/studio/frontend/src/i18n/locales/zh-CN.ts
+++ b/studio/frontend/src/i18n/locales/zh-CN.ts
@@ -2365,8 +2365,11 @@ export const zhCN = {
title: "智能体",
description:
"使用 unsloth start 将 Claude Code、Codex 等编程智能体连接到本地模型。",
+ agentKeywords: "vs code vscode copilot pi mistral vibe deepseek harness hermes openclaw opencode claude codex",
+ vscodeNote:
+ "VS Code 是例外:此命令会将正在提供的模型添加到 VS Code 的 Copilot Chat 模型列表(chatLanguageModels.json)中。",
intro:
- "可将 Claude Code、Codex、DeepSeek Harness、Hermes、Mistral Vibe、OpenClaw、OpenCode 等智能体连接到由 Unsloth 在本地提供服务的模型,全程离线。它会启动一个兼容 OpenAI 的服务器,并且从不改动智能体的配置文件。",
+ "可将 Claude Code、Codex、DeepSeek Harness、Hermes、OpenClaw、OpenCode 等智能体连接到由 Unsloth 在本地提供服务的模型,全程离线。它会启动一个兼容 OpenAI 的服务器,并且从不改动智能体的配置文件。",
readDocs: "查看文档",
copy: "复制",
copied: "已复制",
@@ -2443,7 +2446,7 @@ export const zhCN = {
launch: "启动智能体,或仅打印命令和环境变量。",
persist: "在多次运行之间保留由 Unsloth 管理的智能体存储。",
asSubagent:
- "让父智能体保持当前模型,并将 Unsloth 注册为本地子智能体(Claude Code、Codex 和 OpenCode)。",
+ "让父智能体保持当前模型,并将 Unsloth 注册为本地子智能体(Claude Code、Codex、OpenCode 和 Pi)。",
apiKey: "提供你的 Unsloth API 密钥(或设置 UNSLOTH_API_KEY)。",
reasoning:
"是否在对话中使用推理:on、off 或 auto。auto 会遵循模型的对话模板,通常为开启。",
diff --git a/studio/frontend/tests/agent-command.test.ts b/studio/frontend/tests/agent-command.test.ts
index b6ab89e9c61..be6ae346831 100644
--- a/studio/frontend/tests/agent-command.test.ts
+++ b/studio/frontend/tests/agent-command.test.ts
@@ -73,6 +73,18 @@ test("the Unix selection reaches every generated command", () => {
assert.match(commands.remoteSetup, /^export UNSLOTH_STUDIO_URL=/);
});
+test("VS Code takes the model flags like the other agents", () => {
+ assert.equal(
+ buildAgentShellCommands(
+ "http://127.0.0.1:8888",
+ "unix",
+ "vscode",
+ "--model unsloth/Qwen3-4B-GGUF --gguf-variant Q4_K_M",
+ ).primary,
+ "unsloth start vscode --model unsloth/Qwen3-4B-GGUF --gguf-variant Q4_K_M",
+ );
+});
+
test("the Windows selection reaches every generated command", () => {
const commands = buildAgentShellCommands(
REMOTE_STUDIO,
diff --git a/studio/frontend/tests/agent-gguf-compatibility.test.ts b/studio/frontend/tests/agent-gguf-compatibility.test.ts
index 6ae9db4a0cb..02e89134df5 100644
--- a/studio/frontend/tests/agent-gguf-compatibility.test.ts
+++ b/studio/frontend/tests/agent-gguf-compatibility.test.ts
@@ -36,6 +36,14 @@ test("the first detected agent that can run the active model wins", () => {
);
});
+test("a detected VS Code is never picked on its own", () => {
+ assert.equal(
+ pickCompatibleAgent(["claude", "vscode", "opencode"], "claude", false),
+ "opencode",
+ );
+ assert.equal(pickCompatibleAgent(["vscode"], "opencode", false), null);
+});
+
test("only GGUF-only agents detected on a safetensors model resets the pick", () => {
assert.equal(pickCompatibleAgent(["claude"], "claude", false), "opencode");
assert.equal(pickCompatibleAgent(["codex"], "codex", false), "opencode");
diff --git a/studio/frontend/tests/agents-model-picker.test.ts b/studio/frontend/tests/agents-model-picker.test.ts
index 53373f08afe..2e49a1ee63d 100644
--- a/studio/frontend/tests/agents-model-picker.test.ts
+++ b/studio/frontend/tests/agents-model-picker.test.ts
@@ -2,7 +2,7 @@
// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
import assert from "node:assert/strict";
-import { readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
import test from "node:test";
import { fileURLToPath } from "node:url";
import {
@@ -186,24 +186,99 @@ test("an adopted resident model does not use a cached load ID", () => {
);
});
-test("the shared agent list keeps the seven agents in order", () => {
+test("the shared agent list keeps the nine agents in order", () => {
assert.deepEqual(
SUPPORTED_AGENTS.map((agent) => agent.id),
- ["claude", "codex", "hermes", "openclaw", "opencode", "dsh", "vibe"],
+ [
+ "claude",
+ "codex",
+ "vscode",
+ "dsh",
+ "opencode",
+ "hermes",
+ "openclaw",
+ "pi",
+ "vibe",
+ ],
);
assert.equal(detailsFor("codex").name, "OpenAI Codex");
- assert.deepEqual(detailsFor("pi"), {
- id: "pi",
- name: "pi",
+ assert.deepEqual(detailsFor("unknown"), {
+ id: "unknown",
+ name: "unknown",
docsUrl: UNSLOTH_START_DOCS_URL,
color: "#64748B",
- mark: "pi",
+ mark: "un",
});
});
+test("every listed agent icon ships in public/agent-logos", () => {
+ for (const agent of SUPPORTED_AGENTS) {
+ for (const file of [agent.icon, agent.darkIcon]) {
+ if (file) {
+ assert.ok(
+ existsSync(new URL(`../public/agent-logos/${file}`, import.meta.url)),
+ file,
+ );
+ }
+ }
+ }
+});
+
test("the Agents tab uses the shared agent list and copy blocks", () => {
assert.match(TAB, /from "\.\.\/components\/coding-agent-list";/);
assert.match(TAB, /from "\.\.\/components\/agent-command-block";/);
assert.doesNotMatch(TAB, /const SUPPORTED_AGENTS/);
assert.doesNotMatch(TAB, /function (CommandBlock|useCopyButton)\(/);
});
+
+test("every agent whose unsloth start supports --as-subagent shows the subagent setup", () => {
+ assert.match(
+ TAB,
+ /const SUBAGENT_AGENT_IDS = new Set\(\["claude", "codex", "opencode", "pi"\]\);/,
+ );
+});
+
+test("every listed agent is findable from settings search", async () => {
+ const { SETTINGS_SEARCH_KEYWORDS } = await import(
+ "../src/features/settings/settings-search.ts"
+ );
+ assert.equal(
+ SETTINGS_SEARCH_KEYWORDS["settings.agents.agent"],
+ "settings.agents.agentKeywords",
+ );
+ for (const name of ["vs code", "pi", "mistral vibe"]) {
+ assert.ok(en.settings.agents.agentKeywords.includes(name), name);
+ }
+});
+
+test("selecting VS Code says its command edits VS Code's model list", () => {
+ assert.match(
+ TAB,
+ /\{selectedAgent === "vscode" && \([\s\S]*?t\("settings\.agents\.vscodeNote"\)/,
+ );
+ assert.match(en.settings.agents.vscodeNote, /chatLanguageModels\.json/);
+});
+
+test("every locale lists Pi among the --as-subagent agents", async () => {
+ const { readdirSync } = await import("node:fs");
+ const dir = fileURLToPath(new URL("../src/i18n/locales/", import.meta.url));
+ for (const file of readdirSync(dir).filter((f) => f.endsWith(".ts"))) {
+ const source = readFileSync(`${dir}${file}`, "utf8");
+ const at = source.indexOf("asSubagent:");
+ assert.ok(at !== -1, file);
+ assert.match(source.slice(at, at + 400), /OpenCode[^"]*Pi/, file);
+ }
+});
+
+test("the API tab shows the VS Code note too", () => {
+ const usage = readFileSync(
+ fileURLToPath(
+ new URL("../src/features/settings/components/usage-examples.tsx", import.meta.url),
+ ),
+ "utf8",
+ );
+ assert.match(
+ usage,
+ /\{agent === "vscode" && \([\s\S]*?t\("settings\.agents\.vscodeNote"\)/,
+ );
+});
diff --git a/studio/frontend/tests/mcp-access-section.test.ts b/studio/frontend/tests/mcp-access-section.test.ts
index ae9eebde706..b43e514cce4 100644
--- a/studio/frontend/tests/mcp-access-section.test.ts
+++ b/studio/frontend/tests/mcp-access-section.test.ts
@@ -141,7 +141,11 @@ test("the agent picker keeps the pill trigger and shared list, CLI agents get th
);
assert.ok(trigger.length > 0);
assert.doesNotMatch(trigger, /rounded-/);
- assert.match(SECTION, /SUPPORTED_AGENTS\.map\(/);
+ assert.match(
+ SECTION,
+ /const MCP_AGENTS = SUPPORTED_AGENTS\.filter\(\(agent\) => hasMcpSnippet\(agent\.id\)\);/,
+ );
+ assert.match(SECTION, /MCP_AGENTS\.map\(/);
assert.match(SECTION, /from "\.\/coding-agent-list";/);
assert.match(SECTION, /from "\.\/agent-command-block";/);
assert.match(SECTION, /MCP_SHELL_AGENT_IDS\.has\(agent\) \? \(\s*<fieldset/);
diff --git a/studio/frontend/tests/mcp-agent-snippet.test.ts b/studio/frontend/tests/mcp-agent-snippet.test.ts
index fbca8985721..95a7d9515b6 100644
--- a/studio/frontend/tests/mcp-agent-snippet.test.ts
+++ b/studio/frontend/tests/mcp-agent-snippet.test.ts
@@ -11,6 +11,7 @@ import { SUPPORTED_AGENTS } from "../src/features/settings/components/coding-age
import {
MCP_SHELL_AGENT_IDS,
buildMcpSnippet,
+ hasMcpSnippet,
mcpEndpointUrl,
} from "../src/features/settings/components/mcp-agent-snippet.ts";
@@ -38,12 +39,19 @@ function snippet(
return result;
}
-test("every listed agent has a snippet and only the CLIs get an OS choice", () => {
- for (const agent of SUPPORTED_AGENTS) {
+const MCP_AGENTS = SUPPORTED_AGENTS.filter((agent) => hasMcpSnippet(agent.id));
+
+test("every MCP-listed agent has a snippet and only the CLIs get an OS choice", () => {
+ assert.deepEqual(
+ MCP_AGENTS.map((agent) => agent.id),
+ ["claude", "codex", "dsh", "opencode", "hermes", "openclaw", "vibe"],
+ );
+ for (const agent of MCP_AGENTS) {
assert.ok(buildMcpSnippet(agent.id, LOCAL, "unix"), agent.id);
}
assert.deepEqual([...MCP_SHELL_AGENT_IDS], ["claude", "codex"]);
assert.equal(buildMcpSnippet("pi", LOCAL, "unix"), null);
+ assert.equal(buildMcpSnippet("vscode", LOCAL, "unix"), null);
});
test("the endpoint is always the origin plus /mcp/", () => {
@@ -237,7 +245,7 @@ test("DeepSeek Harness evaluates the key with !!js, or takes a plain string", ()
});
test("no snippet carries a key unless one is passed", () => {
- for (const agent of SUPPORTED_AGENTS) {
+ for (const agent of MCP_AGENTS) {
for (const os of ["unix", "windows"] as const) {
for (const base of [LOCAL, TUNNEL, LAN]) {
for (const key of [null, ""]) {