Add packages/dsh-snapcompact to dsh.profile.bundles in your profile's package.json (e.g. ~/.dsh/profiles/desktop/package.json):

{
  "dsh": {
    "profile": {
      "bundles": [
        "packages/dsh-snapcompact"
      ]
    }
  }
}

The plugin automatically mounts its Cordis row via the bundled cordis.patch.yml.

In any DSH session chat:

/snapcompact — Archive older history immediately using smart defaults (auto shape, max 8 frames, retains 16% recent tokens in plain text).
/snapcompact auto — Toggle automatic background compaction when the agent is idle.
/snapcompact auto on — Enable automatic idle compaction.
/snapcompact auto off — Disable automatic idle compaction.
/snapcompact auto threshold — Set context window threshold percentage to trigger idle compaction (default 80%).
/snapcompact status — Display current configuration, threshold, and live session token usage.
/snapcompact --frames — Archive history with custom maximum frame count.
/snapcompact --shape — Archive history with specific font/shape variant (11on16-bw, 8on22-bw, silver16-bw).
/snapcompact --all — Archive all eligible history without retaining recent plain text.

Auto-compaction preferences are saved to ~/.dsh/snapcompact-config.json and persist across sessions and application restarts.

const snapcompact = ctx.get("snapcompact");
await snapcompact.compactNow(agent, signal);

dsh-snapcompact

インストール