Official

chat

Built-in chat 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/chat@0.2.9

Permissions in 0.2.9

  • Control chats chats.controlHighCreates chats, sends prompts and cancels runs.Send prompts, answer agent questions, and create, change, fork, revert, stop and group chats
  • Run other plugins' commands commands.runHighRuns commands of other plugins.Run the sidebar's New chat command from the title bar, and its Close Chat and Reopen Closed Chat for Cmd+W and Cmd+Shift+T on a chat's only tab
  • Read chats chats.readMediumReads your transcripts and chat lists.Show workspaces, tasks, chats and transcripts, and follow them as agents work
  • Read files fs.readMediumReads files in the listed places.Suggest workspace files for @ mentionsPlaces: the open workspace
  • Show panels ui.slotsAlways grantedShows views in the listed parts of the window.Draw the chat grid, the title bar, and the Session panel with its rail buttonSlots: centertitlerailright

Files

message-text.test.ts1.6 KB
import assert from "node:assert/strict";
import test from "node:test";
import { markedMessage } from "./message-text.ts";
import type { Known } from "./segments.ts";

const known: Known = {
  mentions: [{ plugin: "agents", id: "codex", token: "codex", label: "Codex" }] as unknown as Known["mentions"],
  skills: [{ name: "review" }],
  commands: [{ name: "compact" }],
};

test("a sent message draws the commands, skills, agents and files it named as the prompt box's pills, and only those", () => {
  assert.equal(markedMessage("/compact", [{ type: "text", text: "/compact" }], known), `[\`compact\`](<> "divergence:pill:square-slash")`);
  assert.equal(
    markedMessage("look at @src/main.ts with @codex", [{ type: "text", text: "look at @src/main.ts with @codex" }, { type: "file_ref", path: "src/main.ts" }], known),
    'look at [`main.ts`](<src/main.ts> "divergence:pill:file") with [`codex`](<> "divergence:pill:bot")',
  );
  assert.equal(markedMessage("$review the diff", [{ type: "skill", name: "review", input: "the diff" }], known), '[`review`](<> "divergence:pill:sparkles") the diff');
  // A file whose path has a space is one pill.
  assert.equal(
    markedMessage("read @docs/My Notes.md first", [{ type: "text", text: "read " }, { type: "file_ref", path: "docs/My Notes.md" }, { type: "text", text: " first" }], known),
    'read [`My Notes.md`](<docs/My Notes.md> "divergence:pill:file") first',
  );
  // Words that only look like them stay as typed.
  const loose = "/usr/bin is where @someone put a.b, and /compact here is not a command; @notes.md was never attached";
  assert.equal(markedMessage(loose, [{ type: "text", text: loose }], known), loose);
});

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.9latestNov 21, 2026>=5 <6349 KB5 permissionsListed
0.2.8Nov 16, 2026>=5 <6348.6 KB5 permissionsListed
0.2.7Nov 11, 2026>=5 <6314.3 KB5 permissionsListed
0.2.6Nov 9, 2026>=5 <6306.2 KB5 permissionsListed
0.2.5Oct 27, 2026>=2 <4178.6 KB5 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.