Cave Agent banner
acodercat acodercat

Cave Agent

AI community

Description

Stateful runtime management for LLM agents—inject, manipulate, and retrieve Python objects across turns.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

CaveAgent

CaveAgent: Transforming LLMs into Stateful Runtime Operators

Website arXiv Paper License: MIT Python 3.12+ PyPI version

"From text-in-text-out to (text&object)-in-(text&object)-out"


Most LLM agents operate under a text-in-text-out paradigm, with tool interactions constrained to JSON primitives. CaveAgent breaks this with **Stateful Runtime Management**—a persistent Python runtime with direct **variable injection and retrieval**:

  • Inject any Python object into the runtime—DataFrames, models, database connections, custom class instances—as first-class variables the LLM can manipulate
  • Persist state across turns without serialization; objects live in the runtime, not in the context window
  • Retrieve manipulated object