ctxkeeper

by bytesagain3

Manage conversation context with saving, loading, and pruning tools. Use when preserving context, loading sessions, pruning old history.

View Chinese version with editor review

安装

claude skill add --url github.com/openclaw/skills/tree/main/skills/bytesagain3/ctxkeeper

文档

Ctxkeeper

A utility toolkit for logging, tracking, and managing operational entries across multiple categories. Each command records timestamped entries to dedicated log files for later review, search, and export.

Data stored in ~/.local/share/ctxkeeper/

Commands

CommandDescription
run <input>Record a run entry. Without args, shows recent run entries.
check <input>Record a check entry. Without args, shows recent check entries.
convert <input>Record a convert entry. Without args, shows recent convert entries.
analyze <input>Record an analyze entry. Without args, shows recent analyze entries.
generate <input>Record a generate entry. Without args, shows recent generate entries.
preview <input>Record a preview entry. Without args, shows recent preview entries.
batch <input>Record a batch entry. Without args, shows recent batch entries.
compare <input>Record a compare entry. Without args, shows recent compare entries.
export <input>Record an export entry. Without args, shows recent export entries.
config <input>Record a config entry. Without args, shows recent config entries.
status <input>Record a status entry. Without args, shows recent status entries.
report <input>Record a report entry. Without args, shows recent report entries.
statsShow summary statistics across all log files (entry counts, data size).
search <term>Search all log files for a term (case-insensitive).
recentShow the last 20 lines from history.log.
helpShow usage and available commands.
versionPrint version string (ctxkeeper v2.0.0).

Requirements

  • Bash 4+

When to Use

  • Tracking context changes, runs, and checks over time with timestamped logs
  • Keeping a structured journal of operational activities across categories
  • Searching historical entries to find when something was run, checked, or analyzed
  • Exporting logged data for review or sharing with teammates
  • Monitoring overall activity via stats and recent commands

Examples

bash
# Record a run entry
ctxkeeper run "deployed api v2.3 to staging"

# Search all logs for a keyword
ctxkeeper search "staging"

# View summary statistics
ctxkeeper stats

# Check recent activity across all categories
ctxkeeper recent

# Record an analyze entry then review it
ctxkeeper analyze "memory usage spike at 14:00"
ctxkeeper analyze

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com