A proactive state management system that ensures AI agent context survives session resets by tracking every task's lifecycle in a persistent markdown file.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install new-agent-task-tracker
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 new-agent-task-tracker 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 Task Tracker?
Task Tracker is a specialized utility within the ecosystem of Openclaw Skills designed to solve the common problem of context loss during session compaction or resets. It functions as a resilient memory layer that maintains a single source of truth in a lightweight markdown file, allowing an AI agent to proactively track background processes, SSH sessions, and multi-step progress.
By implementing a write-first approach, this skill ensures that every transition—from task initiation to completion or failure—is recorded before the agent even responds to the user. This makes it an indispensable tool for developers who require high-reliability automation and long-running task execution without losing situational awareness.
Task Tracker Use Cases
- Maintaining context across AI session resets and history compactions.
- Monitoring long-running background processes and tracking PIDs on remote servers.
- Managing complex, multi-step technical migrations where state persistence is critical.
- Providing a clear audit trail of completed and failed tasks for human review.
How Task Tracker Works
- At the start of any new session, the agent reads the state file to resume awareness of previous activities.
- When a task is received, the agent immediately adds an entry with a status indicator to the active tasks list.
- For any background process, the skill captures the session ID, PID, server name, and the specific command executed.
- Every progress update or state change is committed to the file before the agent reports back to the user.
- Upon completion or failure, the task is updated with final results and eventually moved to a pruned archive section.
Task Tracker Setup
To implement this within your environment for Openclaw Skills, ensure your workspace has the appropriate directory structure. The skill operates automatically once the state file is initialized.
# Create the memory directory if it doesn't exist
mkdir -p memory
# Initialize the state file
touch memory/tasks.md
Task Tracker Data Schema & Taxonomy
The skill organizes data within memory/tasks.md using a strict format to ensure it stays under the 2KB size limit.
| Feature | Details |
|---|---|
| Storage Path | memory/tasks.md |
| Task Status | Uses visual icons for In Progress, Completed, Failed, and Paused |
| Timestamps | ISO-style YYYY-MM-DD HH:MM for requests and updates |
| Process Metadata | Captures Session ID, PID, and Command for background tasks |
| Retention | Prunes completed tasks older than 3 days to save space |
Task Tracker Advanced Features
- Proactive Write-First Protocol: Updates state files before reporting to the user to prevent data loss.
- Background Process Awareness: Specifically tracks SSH sessions and remote server commands for persistent monitoring.
- Auto-Pruning Logic: Automatically collapses and removes old task data to keep the file under 50 lines for optimized token consumption.
- Multi-Agent Compatibility: Provides a standardized state format that can be read by different agents within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
My Awesome Tools
A versatile collection of shell scripts designed to automate the generation of Chrome extensions, READMEs, landing pages, and more.
ML Pipeline Starter
A comprehensive framework for building, training, and deploying production-grade machine learning pipelines.
Microservices Starter
A powerful architectural toolkit for building, deploying, and monitoring production-grade microservices across multiple languages.
Medical Imaging Suite
A professional-grade medical imaging solution featuring OHIF viewer deployment and AI-powered DICOM segmentation.
AI News Digest
An automated news aggregation and summarization tool for staying updated on the latest AI and technology trends.
AkShare Stock Data Tool
A powerful quantitative data tool for A-shares providing real-time quotes, financial indicators, and market sentiment analysis.
Featured*
