← Back to Skills Marketplace
kid0114

subsession-delete

by kid0114 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
56
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install subsession-delete
Description
Delete an OpenClaw child session cleanly by removing its transcript, trajectory files, and sessions.json index entry.
Usage Guidance
This tool appears to do exactly what it says: permanently delete session files and clean the session index locally. Before running with --execute: (1) run the default dry-run first to see which files would be removed; (2) backup ~/.openclaw/agents/<agent>/sessions/sessions.json (and any transcripts) so you can restore if needed; (3) confirm you are operating on the correct agent and not a primary/active session; (4) run as the same user who owns the .openclaw files (do not run as root unnecessarily); (5) be aware the prune logic removes JSON nodes whose sessionId matches or whose key equals the sessionKey — if your sessions.json has unexpected structure this could remove more than a single entry. No network traffic or credentials are used by this skill.
Capability Analysis
Type: OpenClaw Skill Name: subsession-delete Version: 1.0.0 The subsession-delete skill is a utility designed to remove OpenClaw session data, including transcripts and index entries. The core logic in scripts/delete_subsession.py is restricted to the ~/.openclaw directory and requires an explicit --execute flag for destructive actions. The SKILL.md documentation includes appropriate safety guardrails and dry-run recommendations, and no indicators of malicious intent, data exfiltration, or unauthorized execution were found.
Capability Assessment
Purpose & Capability
The name/description match the included script and SKILL.md: the script locates session files under ~/.openclaw/agents/<agent>/sessions, deletes the transcript and trajectory files, and rewrites sessions.json. No unrelated credentials, binaries, or network access are requested.
Instruction Scope
SKILL.md and the script confine actions to local session files and the sessions.json index. This is destructive by design; the skill recommends dry-run by default. Note: there is no automatic backup before overwriting sessions.json and the prune logic removes any JSON entries whose sessionId matches (or keys that equal the sessionKey), so users should confirm the target and consider backing up sessions.json first.
Install Mechanism
Instruction-only skill with a small included Python script; there is no install step, no third-party downloads, and nothing is written to system locations beyond the targeted sessions directory.
Credentials
No environment variables, credentials, or external tokens are requested or used. The script reads/writes only the sessions directory under the current user's home — proportionate to the stated task.
Persistence & Privilege
The skill does not request permanent/always-on inclusion and does not modify other skills or global agent settings. It writes only to the agent's sessions.json and target session files under ~/.openclaw; this is expected for a deletion tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install subsession-delete
  3. After installation, invoke the skill by name or use /subsession-delete
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: delete child sessions cleanly by removing transcript, trajectory files, and sessions.json index entries with verification.
Metadata
Slug subsession-delete
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is subsession-delete?

Delete an OpenClaw child session cleanly by removing its transcript, trajectory files, and sessions.json index entry. It is an AI Agent Skill for Claude Code / OpenClaw, with 56 downloads so far.

How do I install subsession-delete?

Run "/install subsession-delete" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is subsession-delete free?

Yes, subsession-delete is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does subsession-delete support?

subsession-delete is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created subsession-delete?

It is built and maintained by kid0114 (@kid0114); the current version is v1.0.0.

💬 Comments