← Back to Skills Marketplace
Ctxkeeper
by
bytesagain3
· GitHub ↗
· v2.0.0
· MIT-0
155
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ctxkeeper
Description
Manage conversation context with saving, loading, and pruning tools. Use when preserving context, loading sessions, pruning old history.
README (SKILL.md)
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
| Command | Description |
|---|---|
run \x3Cinput> |
Record a run entry. Without args, shows recent run entries. |
check \x3Cinput> |
Record a check entry. Without args, shows recent check entries. |
convert \x3Cinput> |
Record a convert entry. Without args, shows recent convert entries. |
analyze \x3Cinput> |
Record an analyze entry. Without args, shows recent analyze entries. |
generate \x3Cinput> |
Record a generate entry. Without args, shows recent generate entries. |
preview \x3Cinput> |
Record a preview entry. Without args, shows recent preview entries. |
batch \x3Cinput> |
Record a batch entry. Without args, shows recent batch entries. |
compare \x3Cinput> |
Record a compare entry. Without args, shows recent compare entries. |
export \x3Cinput> |
Record an export entry. Without args, shows recent export entries. |
config \x3Cinput> |
Record a config entry. Without args, shows recent config entries. |
status \x3Cinput> |
Record a status entry. Without args, shows recent status entries. |
report \x3Cinput> |
Record a report entry. Without args, shows recent report entries. |
stats |
Show summary statistics across all log files (entry counts, data size). |
search \x3Cterm> |
Search all log files for a term (case-insensitive). |
recent |
Show the last 20 lines from history.log. |
help |
Show usage and available commands. |
version |
Print 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
# 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 | [email protected]
Usage Guidance
Ctxkeeper appears to do what it says: a local CLI-style logger that keeps timestamped logs under ~/.local/share/ctxkeeper and can search/export them. There are no network calls or credential requests. Before installing or using it: (1) review or run the included scripts/script.sh yourself — the package doesn't provide an automatic installer, so you may need to place the script on your PATH if you want the 'ctxkeeper' command; (2) avoid recording secrets or sensitive tokens in the logs (they are stored in plain text and exported to files in your home directory); (3) be aware of minor bugs/quirks in the exporter (e.g., JSON output handling and literal "\n" in the script) — these are implementation issues, not malicious behavior; (4) if you want stronger guarantees, run it in an isolated account or container until you are comfortable with the behavior.
Capability Analysis
Type: OpenClaw Skill
Name: ctxkeeper
Version: 2.0.0
The ctxkeeper bundle is a simple Bash-based logging utility designed to record and search timestamped entries in a local directory (~/.local/share/ctxkeeper). While the script contains logic errors—specifically duplicate 'case' branches in scripts/script.sh that prevent the functional '_export' and '_status' routines from ever executing—there is no evidence of malicious intent, data exfiltration, or unauthorized system access.
Capability Assessment
Purpose & Capability
Name/description (manage conversation context, saving/loading/pruning) matches the included script's behavior: timestamped category logs, search, stats, export, recent. No unrelated credentials, binaries, or services are requested.
Instruction Scope
SKILL.md and scripts confine activity to the user's data directory (~/.local/share/ctxkeeper) and only read/write the log files there. They do not reference other system config, network endpoints, or unrelated env vars. Note: the SKILL.md presents a CLI named 'ctxkeeper' but the repo contains scripts/script.sh without an explicit install step or wrapper; this is a mild inconsistency (the script exists but there is no automated install to PATH).
Install Mechanism
No install spec (instruction-only) — lowest install risk. However, a shell script is included in the package; there are no instructions to install it to PATH. That is not dangerous per se, but you may need to run or install the script manually.
Credentials
The skill requests no environment variables, credentials, or external config. The script only uses HOME to determine the data directory and standard shell utilities; this is proportionate to a local logging tool.
Persistence & Privilege
always is false and model invocation is not disabled (normal). The skill does not request permanent elevated privileges or modify other skills or system-wide settings. It creates and uses its own data directory only.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ctxkeeper - After installation, invoke the skill by name or use
/ctxkeeper - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
publish v2.0.0
Metadata
Frequently Asked Questions
What is Ctxkeeper?
Manage conversation context with saving, loading, and pruning tools. Use when preserving context, loading sessions, pruning old history. It is an AI Agent Skill for Claude Code / OpenClaw, with 155 downloads so far.
How do I install Ctxkeeper?
Run "/install ctxkeeper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ctxkeeper free?
Yes, Ctxkeeper is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ctxkeeper support?
Ctxkeeper is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ctxkeeper?
It is built and maintained by bytesagain3 (@bytesagain3); the current version is v2.0.0.
More Skills