referenceJune 10, 2026· 3 min read

How to use CTOOLSET and CTOOLGET: cache a tool call

CTOOLSET caches a tool result keyed by tool plus exact arguments; CTOOLGET returns it, so a deterministic call runs once and serves many.

Agents call the same tools with the same arguments constantly. Cache the result keyed by tool and args, and a swarm's duplicate lookups become one call.

crowkis cli

> CTOOLSET weather '{"city":"Berlin"}' '{"temp":7,"sky":"cloudy"}'
OK
> CTOOLGET weather '{"city":"Berlin"}'
'{"temp":7,"sky":"cloudy"}'
> CTOOLGET weather '{"city":"Munich"}'
(nil)              # different args -> different key -> run the tool

Exact-args keying means no fuzzy-match risk: Berlin and Munich are correctly distinct.