Official

settings

Built-in settings UI (JavaScript UI plugin).

The app opens the listing; nothing installs until an agent in your Plugins workspace has read the files and you enable the plugin. In a terminal: dvg install divergence/settings@0.2.5

Permissions in 0.2.5

  • Manage plugins plugins.manageOfficial onlyReloads and enables plugins. Only official plugins can have it.List, enable, disable and reload plugins, install updates, and quit to finish an update
  • Change app settings settings.writeHighChanges the app settings.Change the settings and the theme
  • Manage agents agents.manageHighEnables, disables and signs in agents, and changes their settings.Turn agents on and off, sign in to them and update them
  • Control chats chats.controlHighCreates chats, sends prompts and cancels runs.Import an agent's own sessions as chats, add project folders, and open the first chat and the changes saved in the first-run guide
  • Read chats chats.readMediumReads your transcripts and chat lists.List the workspaces an agent's sessions can be imported into, and hold an agent's update until its chats stop running
  • Read app settings settings.readLowReads the app settings.Show the settings, and the tools and rules of every plugin
  • Show panels ui.slotsAlways grantedShows views in the listed parts of the window.Draw settings, its list of sections in the sidebar's place, and the first-run guideSlots: centerleft

Files

views/chat-import.tsx1.9 KB
// One preference and its live status, shared by agent onboarding and General.
import type { EffectViewContext } from "divergence/effect";
import type { ChatImport } from "../chat-import.ts";
import { column, setting } from "./layout.tsx";

export function renderChatImport(ctx: EffectViewContext<object>, imports: ChatImport["Service"]) {
  return (
    <div {...column} gap="medium">
      {setting({
            title: "Automatically import chats",
            description:
              "Import existing chats from enabled agents after adding project folders, at startup, and when agents become ready. The Plugins workspace is excluded.",
            control: chatImportSwitch(ctx, imports),
          })}
      {chatImportStatus(ctx, imports)}
    </div>
  );
}

export const chatImportSwitch = (ctx: EffectViewContext<object>, imports: ChatImport["Service"]) =>
  <switch id="auto-import-chats" label="" checked={imports.state.enabled} onChange={(e: { value: boolean }) => ctx.run(imports.setEnabled(e.value))} />;

// What the import is doing: under way, done, or what failed.
export function chatImportStatus(ctx: EffectViewContext<object>, imports: ChatImport["Service"]) {
  const state = imports.state;
  return [
    state.enabled && state.running ? <div {...column} paddingX="medium"><text style="body" size="sm" tone="muted">Importing existing chats…</text></div> : null,
    state.enabled && state.imported ? (
      <div {...column} paddingX="medium">
        <text style="body" size="sm" tone="muted">{`Imported ${state.imported} ${state.imported === 1 ? "chat" : "chats"}.`}</text>
      </div>
    ) : null,
    state.errors.length
      ? (
        <callout tone="danger" title="Some chats could not be imported" text={state.errors.join("\n")}>
          <button id="auto-import-retry" label="Retry imports" small disabled={state.running} onClick={() => ctx.run(imports.retry())} />
        </callout>
      )
      : null,
  ];
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.8latestNov 21, 2026>=5 <668.5 KB7 permissionsListed
0.2.7Nov 18, 2026>=5 <668 KB7 permissionsListed
0.2.6Nov 16, 2026>=5 <666.3 KB7 permissionsListed
0.2.5Nov 11, 2026>=5 <663.6 KB7 permissionsListed
0.2.4Nov 9, 2026>=5 <661.6 KB7 permissionsListed
0.2.3Oct 27, 2026>=2 <446.8 KB7 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.