Official

codex

Codex agent provider: runs the Codex CLI's app-server for each account.

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/codex@0.2.4

Permissions in 0.2.4

  • Provide agents agents.provideMediumAdds agents to the app.Provide the Codex agent and pass its tool calls to plugin tools
  • Run named programs processMediumStarts the listed programs.Run the Codex CLI, and ask or tell the installer that owns it (npm or Homebrew) about a newer versionPrograms: codexnpmbrew
  • Environment variables envMediumReads the listed environment variables.Find each account's Codex home, and pass extra app-server arguments set in CODEX_ARGSVariables: HOMECODEX_HOMECODEX_ARGS
  • Read files fs.readMediumReads files in the listed places.Notice a conversation started in the Codex app or CLI, so it shows up at once, and read, once, the accounts the previous Codex provider keptPlaces: its own data folder~/.codex/sessions~/.codex/sessions/**~/.codex*/sessions~/.codex*/sessions/**

Files

quota.ts1.4 KB
// Display snapshots merge sparse pushes; recovery permission always uses fresh evidence.
import type * as z from "zod";
import type * as wire from "./wire.ts";
type Limits = z.infer<typeof wire.limits>;

function mergeValues<T extends object>(previous: T | null | undefined, update: T): T {
  const merged = { ...previous, ...update };
  for (const key of Object.keys(update) as (keyof T)[]) {
    const value = update[key];
    if (value == null && previous?.[key] != null) merged[key] = previous[key];
    else if (value && typeof value === "object" && !Array.isArray(value)) merged[key] = mergeValues(previous?.[key] as object | undefined, value) as T[keyof T];
  }
  return merged;
}

export function mergeLimits(previous: Limits | null, update: Limits): Limits {
  const merged = mergeValues(previous, update);
  const buckets = mergeValues(previous?.rateLimitsByLimitId, update.rateLimitsByLimitId ?? {});
  if (previous?.rateLimits?.limitId && !buckets[previous.rateLimits.limitId]) buckets[previous.rateLimits.limitId] = previous.rateLimits;
  if (update.rateLimits?.limitId) buckets[update.rateLimits.limitId] = mergeValues(buckets[update.rateLimits.limitId], update.rateLimits);
  if (update.rateLimits?.limitId && update.rateLimits.limitId !== previous?.rateLimits?.limitId) merged.rateLimits = buckets[update.rateLimits.limitId];
  if (Object.keys(buckets).length) merged.rateLimitsByLimitId = buckets;
  return merged;
}

Versions

VersionPublishedPlugin APISizePermissionsStatus
0.2.5latestNov 21, 2026>=5 <6121.1 KB4 permissionsListed
0.2.4Nov 16, 2026>=5 <6120.2 KB4 permissionsListed
0.2.3Nov 11, 2026>=5 <695.2 KB4 permissionsListed
0.2.2Nov 9, 2026>=5 <688.9 KB4 permissionsListed
0.2.1Oct 27, 2026>=2 <484.1 KB4 permissionsListed

Reviews and comments

0 threads · 0 reviews

No comments yet.