← Back to Skills Marketplace
115
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install session-tracker
Description
ALWAYS use this skill for ANY multi-step task, complex task, or task that could be interrupted. YOU MUST use session-tracker whenever working on anything wit...
Usage Guidance
This skill's SKILL.md describes a CLI and background monitor that write checkpoint files and scan project directories, but the package includes no binary or install steps — that mismatch is the main red flag. Before installing or using this skill: 1) Ask the publisher for the actual implementation/binary or an install script and inspect it; 2) Verify exactly what path will be used for SESSION_DIR and whether it will touch any directories with sensitive data (especially the 'skills' directory); 3) If you proceed, run it in an isolated project or sandbox first so you can review all created files (state.json, worklog.jsonl, monitor.pid, etc.); 4) Prefer skills that provide source code or documented, auditable install steps; 5) If you cannot obtain/inspect the implementation, do not grant it persistent filesystem access or run it on sensitive projects.
Capability Analysis
Type: OpenClaw Skill
Name: session-tracker
Version: 2.1.0
The session-tracker skill is a robust utility designed to maintain state and recover progress for multi-step tasks across agent session interruptions. It implements a background monitor process (session_tracker.py) that uses filesystem scanning and 'micro-dumps' to detect activity or 'stuck' states, and a 'Gridman Outsider' pattern to alert new agents of previous crashes via worklog.md. While the SKILL.md uses forceful instructions to ensure agent compliance and the script manages background processes, all behaviors are transparently documented, aligned with the stated purpose of task persistence, and show no evidence of malicious intent, data exfiltration, or unauthorized access.
Capability Assessment
Purpose & Capability
The skill claims to provide a session-tracking CLI and background monitor that checkpoints state to disk. However, the registry entry contains only SKILL.md (no code, no install). The README repeatedly refers to running a 'session-tracker' command and a background monitor process, which cannot exist unless the environment already supplies that binary or the package installs it. Hardcoded default paths (/home/z/my-project/...) and explicit monitoring of a 'skills' directory are plausible for a tracker, but require filesystem access and a real implementation — which is missing.
Instruction Scope
The instructions direct the agent to create and write persistent session files, run a background monitor (monitor.pid, microdump files), and actively scan multiple directories (download, upload, .session, skills). They also instruct reading session state and checking for orphaned sessions. This goes beyond a simple stateless helper: it instructs persistent disk writes and recursive filesystem monitoring, including a directory for 'skill invocations' which could reveal other agents' outputs. Because there's no code provided, it's unclear who/what should perform these actions and how.
Install Mechanism
No install specification or code files are provided, yet SKILL.md repeatedly references a CLI and a background monitor. An instruction-only skill that requires a custom binary or daemon but provides neither is incoherent and risky: it either assumes an out-of-band installation (not documented) or it will instruct the agent to create ad-hoc scripts/processes, which is unclear and potentially unsafe.
Credentials
The skill requests no environment variables or credentials, which is proportionate in that it doesn't ask for secrets. However, it requires broad filesystem access (read metadata and write persistent state under /home/z/my-project/) and will scan a 'skills' directory. That level of disk access is reasonable for a session tracker, but should be explicit and auditable — especially because it could expose other tools' outputs or sensitive files.
Persistence & Privilege
The skill's workflow creates persistent artifacts (state.json, worklog.jsonl, microdump files, monitor.pid, sentinel file) and expects a long-running background monitor. While 'always' is false, these instructions still establish on-disk persistence and a process model that survives conversation restarts. Without concrete install code or provenance, this persistence is a cautionary flag.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-tracker - After installation, invoke the skill by name or use
/session-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
## What's New in v2.1
| Feature | v1 | v2 | v2.1 |
|---------|----|----|----|
| Stuck detection | Micro-dump only | FS scanner + micro-dump | Same |
| Activity detection | Manual only | Auto via `os.stat` | Same |
| File reading | Not tracked | `--reading` + atime | Same |
| Heartbeat | None | `ping` command | Same |
| File renames | Not tracked | `--rename` | Same |
| TodoWrite sync | None | `sync` command | Same |
| Resume info | Steps only | Steps + worklog | Same |
| **Meta-crash detection** | None | None | **ACTIVE sentinel + `crash-detect`** |
| **Orphan auto-detection** | None | None | **`init` warns about crashed sessions** |
| **Crash marker in worklog.md** | None | None | **Any new agent sees the crash** |
| **Recovery report** | None | None | **`crash-detect` command** |
Metadata
Frequently Asked Questions
What is Session Tracker?
ALWAYS use this skill for ANY multi-step task, complex task, or task that could be interrupted. YOU MUST use session-tracker whenever working on anything wit... It is an AI Agent Skill for Claude Code / OpenClaw, with 115 downloads so far.
How do I install Session Tracker?
Run "/install session-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session Tracker free?
Yes, Session Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Session Tracker support?
Session Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session Tracker?
It is built and maintained by DarkD (@darkd); the current version is v2.1.0.
More Skills