Ctxkeeper is a specialized utility for logging, tracking, and managing operational entries across multiple categories to maintain a persistent record of AI agent activity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ctxkeeper
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ctxkeeper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Ctxkeeper?
Ctxkeeper serves as a robust operational journal designed for developers using Openclaw Skills. It allows for the precise tracking of context changes, system runs, and checks over time by recording timestamped entries into dedicated log files. This ensures that every action taken by an AI agent—from code generation to data analysis—is archived for future review.
By providing a structured way to manage conversation context and operational history, Ctxkeeper solves the problem of context drift and loss. It creates a reliable audit trail, making it an indispensable tool for teams who need to monitor long-term agent behaviors, troubleshoot issues, or export activity logs for stakeholder reporting.
Ctxkeeper Use Cases
- Tracking granular context changes and system runs over extended development periods.
- Maintaining a structured, timestamped journal of AI operational activities across distinct categories.
- Performing historical audits to pinpoint exactly when specific analyses or checks were executed.
- Exporting logged operational data to share progress and logs with teammates.
- Monitoring overall system activity and data growth through centralized statistics.
How Ctxkeeper Works
- The user or agent invokes a specific command (like run, check, or analyze) with an input string describing the action.
- Ctxkeeper captures the input and appends it to a category-specific log file located in the local share directory.
- Each entry is automatically timestamped to ensure chronological accuracy and traceability.
- Users can query the entire log repository using search or statistics commands to retrieve historical data.
- The tool provides summary views via recent and stats commands to give an immediate overview of recent agent activity.
Ctxkeeper Setup
Ctxkeeper requires Bash 4 or higher. To begin using this within your Openclaw Skills environment, ensure the utility is executable in your path. Data is stored by default in ~/.local/share/ctxkeeper/.
# Check the version to ensure installation
ctxkeeper version
# View the help menu for all available logging categories
ctxkeeper help
Ctxkeeper Data Schema & Taxonomy
Ctxkeeper organizes data into category-specific log files with a central history file. The data is stored in the following structure:
| File Type | Description | Location |
|---|---|---|
| Category Logs | Individual logs for run, check, analyze, etc. | ~/.local/share/ctxkeeper/*.log |
| History Log | A master file containing the last 20 global actions. | ~/.local/share/ctxkeeper/history.log |
| Metadata | Entry counts and data sizes for stats reporting. | Managed internally via log parsing |
Each entry follows a standard format: [TIMESTAMP] [CATEGORY] [MESSAGE].
Ctxkeeper Advanced Features
- Multi-category logging: Separate streams for run, check, convert, analyze, generate, preview, batch, compare, export, config, status, and report.
- Global Search: Case-insensitive search across the entire log ecosystem to find specific terms quickly.
- Summary Analytics: The stats command provides a high-level view of data size and entry counts across all categories.
- Context Pruning: Use the log management tools to maintain clean environments by identifying and removing old session history.
- Operational Export: Dedicated export command to facilitate the transfer of logged data into other formats or systems.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw TTS Voice Switch
A specialized skill for OpenClaw that automates ElevenLabs voice swapping, configuration updates, and gateway restarts for seamless text-to-speech management.
Persona Forge
A local-first CLI toolkit for designing, analyzing, and managing complex character personas and their developmental arcs.
Pricing Strategy
An expert AI framework for designing SaaS pricing models that maximize value capture and align with customer willingness to pay.
Aptos TypeScript SDK Transactions
A comprehensive guide for managing the full lifecycle of Aptos blockchain transactions using the official TypeScript SDK.
Humanizer-zh: AI Content Refinement
A precision tool for identifying and stripping AI-generated patterns from Chinese text to produce natural, human-centric content.
Russian Humanizer
A professional editing skill designed to identify and remove artificial patterns and clichés from Russian-language AI output.
Featured*
