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.6
Permissions in 0.2.6
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
| Version | Published | Plugin API | Size | Permissions | Status |
|---|---|---|---|---|---|
| 0.2.8latest | Nov 21, 2026 | >=5 <6 | 68.5 KB | 7 permissions | Listed |
| 0.2.7 | Nov 18, 2026 | >=5 <6 | 68 KB | 7 permissions | Listed |
| 0.2.6 | Nov 16, 2026 | >=5 <6 | 66.3 KB | 7 permissions | Listed |
| 0.2.5 | Nov 11, 2026 | >=5 <6 | 63.6 KB | 7 permissions | Listed |
| 0.2.4 | Nov 9, 2026 | >=5 <6 | 61.6 KB | 7 permissions | Listed |
| 0.2.3 | Oct 27, 2026 | >=2 <4 | 46.8 KB | 7 permissions | Listed |
No comments yet.