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

Permissions in 0.2.8

  • 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.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.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/general.tsx4.3 KB
// The General section: appearance, runs, session import and the bug report.
// HTM whitespace is significant; keep these templates out of Prettier's HTML formatter.
import type { EffectViewContext } from "divergence/effect";
import type { SettingsPage } from "../controller.ts";
import { card, limit, section, segmented, setting, column } from "./layout.tsx";

export function renderGeneral(ctx: EffectViewContext<object>, actions: SettingsPage["Service"]) {
  const state = actions.state;
  const s = state.data.settings;
  // `renderGeneral` runs only once the settings have loaded.
  if (!s) return <empty>Loading…</empty>;
  return (
    <div {...column} gap="large" padding="small">
      {section(
                "Appearance",
                null,
                card([
                  setting({
                    title: "Color scheme",
                    description: "Follow the system, or keep one look.",
                    control: segmented(
                      "appearance",
                      s.appearance,
                      [
                        { value: "system", label: "System" },
                        { value: "light", label: "Light" },
                        { value: "dark", label: "Dark" },
                      ],
                      (value) => ctx.run(actions.changeAppearance(value)),
                    ),
                  }),
                  setting({
                    title: "Theme",
                    description: "Presets, colours, type and density: the Themes plugin's settings.",
                    control: <button id="open-themes" label="Edit themes" onClick={() => ctx.run(actions.openSection("plugin:themes", "themes"))} />,
                  }),
                ]),
              )}
      {section(
                "Runs",
                null,
                card([
                  setting({
                    title: "Checkpoints",
                    description:
                      "Record the workspace before every prompt, so a message can be reverted together with the files it changed.",
                    control: <switch id="checkpoints" label="" checked={s.checkpoints} onChange={(e: { value: boolean }) => ctx.run(actions.updateSettings({ checkpoints: e.value }))} />,
                  }),
                  setting({
                    title: "Keep checkpoints for",
                    description: "Older checkpoints are deleted, and their messages can no longer be reverted.",
                    control: limit(
                      "checkpoint-days",
                      s.checkpointRetentionDays,
                      [7, 14, 30, 90],
                      (days) => `${days} days`,
                      "Forever",
                      (value) => ctx.run(actions.updateSettings({ checkpointRetentionDays: value })),
                    ),
                  }),
                  setting({
                    title: "Checkpoint storage limit",
                    description: "Past this size the oldest checkpoints go first. Those from the last day are always kept.",
                    control: limit(
                      "checkpoint-size",
                      s.checkpointMaxMegabytes,
                      [512, 1024, 2048, 5120, 10240],
                      (mb) => (mb < 1024 ? `${mb} MB` : `${mb / 1024} GB`),
                      "No limit",
                      (value) => ctx.run(actions.updateSettings({ checkpointMaxMegabytes: value })),
                    ),
                  }),
                ]),
              )}
      {section(
                "Help",
                null,
                card([
                  setting({
                    title: "Welcome to Divergence",
                    description: "A quick guide to plugins, agents and making the app your own.",
                    control: <button id="open-onboarding" label="Open guide" icon="sparkles" onClick={() => ctx.run(actions.route("onboarding"))} />,
                  }),
                  setting({
                    title: "Report a bug",
                    description:
                      "Tell us, or a plugin's publisher, what went wrong. You see everything that is sent before it goes.",
                    control: <button id="report-bug" label="Report a bug…" icon="bug" variant="outline" onClick={() => ctx.run(actions.reportBug())} />,
                  }),
                ]),
              )}
    </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.