mcpField
C
catalyst-cache

catalyst-cache

github.com/catalystbyzohoData & databases701.0k installsUpdated today
Repository

About catalyst-cache

A skill that helps developers use Catalyst cache segments through the SDK. It documents string-only values, TTL behavior, and important update and delete caveats.

Key features

  1. 01Cache segment ID lookup
  2. 02SDK get, put, update, and delete guidance
  3. 03String-value serialization guidance
  4. 04TTL limits and behavior
  5. 05Update and delete caveats

Use cases

  1. 01Storing temporary session data
  2. 02Choosing cache for temporary data
  3. 03Troubleshooting unexpected TTL or delete behavior

MCP support

When available, it uses MCP's `CatalystbyZoho_List_Cache_Segments` to find a Segment ID. It describes MCP as a lookup option, not an MCP server interface.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-cache

After installing, type/catalyst-cachein Claude Code to confirm it loaded.

Bundled filesreferences/cache-basics.md

Details

From the project README

How It Works

  1. Get Segment ID — Use MCP (CatalystbyZoho_List_Cache_Segments) if available; otherwise retrieve it from the console or .catalystrc.
  2. Load references/cache-basics.md — for SDK operations, TTL limits (48 hr max), and the segment.delete() / segment.update() gotchas.
  3. String values only — All cache values are strings. Always JSON.stringify before put and JSON.parse after get.
  4. TTL behavior — TTL is in HOURS (max 48), not seconds. segment.update() called WITHOUT an expiry argument silently resets the key's TTL to the 48-hour maximum (a 1-hour key becomes a 48-hour key). segment.delete() does not remove the key — it sets cache_value to null and the key persists; a later getValue() returns null with HTTP 200 and never throws.

Triggers

Use this skill for: "Cache", "cache segment", "cache key", "cache value", "TTL", "in-memory store", segment.get, segment.put, segment.delete, "session data", "temporary data Catalyst", "cache vs Data Store", or "48-hour cache".

References

ReferenceLoad when the query is about…
references/cache-basics.mdSDK operations (get, put, delete, update), Segment ID, 48hr TTL max, string-only values, segment.delete() null gotcha, segment.update() TTL gotcha

Comments

Markdown supported