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.4

Permissions in 0.2.4

  • 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/workspaces.tsx2.3 KB
// The Workspaces section: each workspace folder, and the mark the app
// shows for it (its project icon, or a folder in one of the preset
// colours) wherever its chats are listed.
// HTM whitespace is significant; keep these templates out of Prettier's HTML formatter.
import type { EffectViewContext } from "divergence/effect";
import type { PresetColor, Workspace } from "divergence";
import type { SettingsPage } from "../controller.ts";
import { card, column, section, setting } from "./layout.tsx";

const title = (color: string) => color.charAt(0).toUpperCase() + color.slice(1);

/// The workspace's mark as it shows now, and the marks it can take.
function looks(w: Workspace, colors: readonly PresetColor[]) {
  const own = w.icon ? { image: w.icon } : w.mark ? { icon: w.mark } : null;
  const value = own && !w.useColor ? "icon" : (w.color ?? "");
  return {
    value,
    options: [
      ...(own ? [{ value: "icon", label: w.icon ? "Project icon" : "App icon", ...own }] : []),
      ...colors.map((color) => ({ value: color, label: title(color), icon: "folder-solid", color })),
    ],
  };
}

export function renderWorkspaces(ctx: EffectViewContext<object>, actions: SettingsPage["Service"]) {
  const { workspaces, colors } = actions.state;
  if (!workspaces.length) return <empty>No workspace folders yet. Add one from the sidebar.</empty>;
  const rows = workspaces.map((w) => {
    const { value, options } = looks(w, colors);
    return setting({
      title: w.name,
      description: w.path,
      control: colors.length
        ? (
          <combobox id={`workspace-look-${w.id}`} value={value} width={220} options={options} onChange={(e: { value?: string }) => {
                if (!e.value || e.value === value) return;
                ctx.run(actions.setWorkspaceColor(w.id, e.value === "icon" ? null : (e.value as PresetColor)));
              }} />
        )
        : null,
    });
  });
  return (
    <div {...column} gap="large" padding="small">
      {section(
                "Workspaces",
                "The icon each workspace shows beside its chats: the project's own icon, or a folder in a colour. A folder without an icon gets a colour of its own. Right-click a workspace in the sidebar's list to change it there.",
                card(rows),
              )}
    </div>
  );
}

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.