The IDE you know, rebuilt in Rust. IntelliJ IDEA–style keymap, tool windows and search-everywhere in a fast native app: editor, code insight, debugger, Git, terminal, database and HTTP clients for 60+ languages.
TypeScript code-editorcross-platformdapdatabase-clientdebuggerdesktop-appdeveloper-toolsgithttp-clientideintellijlsprusttauriterminal
/**
* Settings › Tools › Agents: the launch command of built-in agents (Claude Code…), and
* agents of the ACP Registry this machine can run, with Install / Update / Remove.
* Installs run in the background with progress, and keep running after the page closes
* (as a background task of the project windows); the page then shows them as installing.
*/
import { useEffect, useMemo, useState } from "react";
import type { AgentRegistry, RegistryAgent, RequestId } from "@/bindings";
import { isCancelled, nextRequestId } from "@/platform/ipc";
import { tx } from "@/platform/i18n";
import { openExternalUrl } from "@/platform/openUrl";
import { Badge, Button, Icon, ProgressBar, SearchField, Spinner, T, Tabs } from "@/ui";
import { confirm } from "@/workbench/messages";
import { providerIcon } from "./model";
import {
DISTRIBUTION_LABEL,
afterInstall,
afterRemove,
matchesQuery,
rowActions,
sortAgents,
tauriCommands,
tauriRegistry,
type CommandsBackend,
type RegistryBackend,
} from "./registry";
import { BuiltinAgents } from "./BuiltinAgents";
import styles from "./AgentRegistry.module.css";
const errorText = (e: unknown) => (e instanceof Error ? e.message : String(e));
/** How often the page checks on installs it did not start. */
const BACKGROUND_POLL_MS = 1500;
interface Job {
id: string;
fraction: number | null;
message: string;
}
interface PageJob extends Job {
request: RequestId;
}
/** An install started before the page opened; its progress shows in the background tasks. */
const backgroundJob = (agent: RegistryAgent): Job => ({
id: agent.id,
fraction: null,
message: tx`Installing ${agent.name} in the background…`,
});
export function AgentRegistryPage({
onChanged,
backend = tauriRegistry,
commandBackend = tauriCommands,
}: {
/** An agent was installed, updated or removed (the agent list changed). */
onChanged?: () => void;
backend?: RegistryBackend;
commandBackend?: CommandsBackend;
}) {
const [tab, setTab] = useState("builtin");
return (
<div className={styles.body}>
<Tabs
variant="compact"
className={styles.tabs}
items={[
{ id: "builtin", label: "Built-in" },
{ id: "registry", label: "ACP Registry" },
]}
activeId={tab}
onSelect={setTab}
aria-label={tx("Agents")}
/>
{tab === "builtin" ? (
<BuiltinAgents backend={commandBackend} onChanged={onChanged} />
) : (
<RegistryList backend={backend} onChanged={onChanged} />
)}
</div>
);
}
function RegistryList({ backend, onChanged }: { backend: RegistryBackend; onChanged?: () => void }) {
const [registry, setRegistry] = useState<AgentRegistry | null>(null);
const [loadError, setLoadError] = useState<string | null>(null);
const [query, setQuery] = useState("");
const [job, setJob] = useState<PageJob | null>(null);
const [removing, setRemoving] = useState<string | null>(null);
const [errors, setErrors] = useState<Record<string, string>>({});
useEffect(() => {
const request = nextRequestId();
let live = true;
backend
.list(request)
.then((r) => live && setRegistry(r))
.catch((e: unknown) => live && !isCancelled(e) && setLoadError(errorText(e)));
return () => {
live = false;
backend.cancel(request);
};
}, [backend]);
// Installs started before the page opened: follow them until they end.
const background = registry?.agents.some((a) => a.installing) ?? false;
useEffect(() => {
if (!background) return;
let live = true;
let request: RequestId | null = null;
const timer = setInterval(() => {
if (request != null) return;
const r = (request = nextRequestId());
backend
.list(r)
.then((next) => {
if (!live) return;
setRegistry(next);
if (!next.agents.some((a) => a.installing)) onChanged?.();
})
.catch(() => {})
.finally(() => {
if (request === r) request = null;
});
}, BACKGROUND_POLL_MS);
return () => {
live = false;
clearInterval(timer);
if (request != null) backend.cancel(request);
};
}, [backend, background, onChanged]);
const agents = useMemo(
() => sortAgents((registry?.agents ?? []).filter((a) => matchesQuery(a, query))),
[registry, query],
);
const busy = job != null || removing != null || background;
const setError = (id: string, error: string | null) =>
setErrors((all) => {
const { [id]: _, ...rest } = all;
return error ? { ...rest, [id]: error } : rest;
});
const install = async (agent: RegistryAgent) => {
if (
agent.noChecksum &&
!(await confirm({
title: tx`Install ${agent.name}`,
message: tx`${agent.name} provides no checksum for its download, so the downloaded file cannot be verified. Install it anyway?`,
ok: tx("Install"),
icon: "warning",
}))
)
return;
const request = nextRequestId();
setError(agent.id, null);
setJob({ id: agent.id, request, fraction: null, message: tx`Installing ${agent.name} ${agent.version}…` });
backend
.install(agent.id, request, (e) =>
setJob((j) =>
j && j.request === request
? e.type === "progress"
? { ...j, fraction: e.fraction, message: e.message }
: { ...j, message: e.text }
: j,
),
)
.then(() => {
setRegistry((r) => r && { ...r, agents: afterInstall(r.agents, agent.id) });
onChanged?.();
})
.catch((e: unknown) => !isCancelled(e) && setError(agent.id, errorText(e)))
.finally(() => setJob(null));
};
const remove = (agent: RegistryAgent) => {
setError(agent.id, null);
setRemoving(agent.id);
backend
.remove(agent.id)
.then(() => {
setRegistry((r) => r && { ...r, agents: afterRemove(r.agents, agent.id) });
onChanged?.();
})
.catch((e: unknown) => setError(agent.id, errorText(e)))
.finally(() => setRemoving(null));
};
return (
<div className={styles.body}>
<SearchField
autoFocus
value={query}
onChange={setQuery}
placeholder={tx("Search the ACP Registry")}
aria-label="Search agents"
clearable
/>
<p className={styles.notice}>
<T>
Agents in the ACP Registry are third-party software. They run on this computer with your permissions and can
read and change your files. Install only agents you trust.
</T>
</p>
{registry?.warning && (
<p className={styles.warning} role="status">
{registry.warning}
</p>
)}
<div className={styles.list} aria-busy={!registry && !loadError}>
{loadError ? (
<p className={styles.error} role="alert">
{tx`Cannot load the ACP Registry: ${loadError}`}
</p>
) : !registry ? (
<div className={styles.loading}>
<Spinner size={14} />
<T>Loading the ACP Registry…</T>
</div>
) : agents.length === 0 ? (
<p className={styles.empty}>
{query ? <T>No agents match</T> : <T>The registry has no agents for this system</T>}
</p>
) : (
<ul className={styles.rows} aria-label="Registry agents">
{agents.map((agent) => (
<AgentRow
key={agent.id}
agent={agent}
job={job?.id === agent.id ? job : agent.installing ? backgroundJob(agent) : null}
removing={removing === agent.id}
disabled={busy}
error={errors[agent.id] ?? null}
onInstall={() => void install(agent)}
onRemove={() => remove(agent)}
onCancel={job?.id === agent.id ? () => backend.cancel(job.request) : undefined}
/>
))}
</ul>
)}
</div>
</div>
);
}
function AgentRow({
agent,
job,
removing,
disabled,
error,
onInstall,
onRemove,
onCancel,
}: {
agent: RegistryAgent;
job: Job | null;
removing: boolean;
disabled: boolean;
error: string | null;
onInstall: () => void;
onRemove: () => void;
/** Absent for an install this page did not start (stop it from the background tasks). */
onCancel?: () => void;
}) {
const actions = rowActions(agent);
const titleId = `agent-${agent.id}`;
return (
<li className={styles.row} aria-labelledby={titleId}>
<div className={styles.main}>
<div className={styles.titleLine}>
<Icon name={providerIcon(agent.id)} size={16} />
<span id={titleId} className={styles.name}>
{agent.name}
</span>
<span className={styles.version}>{agent.installed ?? agent.version}</span>
{agent.distribution && <Badge>{DISTRIBUTION_LABEL[agent.distribution]}</Badge>}
{agent.noChecksum && <Badge tone="warning">{tx("No checksum provided")}</Badge>}
{actions.update && <Badge tone="accent">{tx`${agent.version} available`}</Badge>}
{agent.installed != null && !actions.update && <Badge tone="success">{tx("Installed")}</Badge>}
</div>
{agent.description && <p className={styles.description}>{agent.description}</p>}
<div className={styles.meta}>
{agent.authors.length > 0 && <span>{agent.authors.join(", ")}</span>}
{agent.license && <span>{agent.license}</span>}
{agent.repository && <ExternalLink url={agent.repository} label="Repository" />}
{agent.website && agent.website !== agent.repository && <ExternalLink url={agent.website} label="Website" />}
</div>
{job && (
<div className={styles.progress}>
<ProgressBar value={job.fraction} aria-label={tx`Installing ${agent.name}`} />
<span className={styles.progressText}>{job.message}</span>
</div>
)}
{error && (
<p className={styles.error} role="alert">
{error}
</p>
)}
</div>
<div className={styles.actions}>
{job ? (
onCancel && (
<Button size="small" onClick={onCancel}>
Cancel
</Button>
)
) : (
<>
{actions.install && (
<Button size="small" variant="primary" disabled={disabled} onClick={onInstall}>
Install
</Button>
)}
{actions.update && (
<Button size="small" variant="primary" disabled={disabled} onClick={onInstall}>
Update
</Button>
)}
{actions.remove && (
<Button size="small" disabled={disabled} onClick={onRemove}>
{removing ? "Removing…" : "Remove"}
</Button>
)}
</>
)}
</div>
</li>
);
}
function ExternalLink({ url, label }: { url: string; label: string }) {
// Links come from the registry: web pages only.
if (!/^https?:\/\//i.test(url)) return null;
return (
<button type="button" className={styles.link} title={url} onClick={() => void openExternalUrl(url)}>
<T>{label}</T>
</button>
);
}