axec-clean

Remove exited axec sessions and their on-disk state.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SpecterShell/axec --skill axec-clean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axec-clean
Source: https://github.com/SpecterShell/axec/tree/main/skills/axec-clean
Command: npx skills add https://github.com/SpecterShell/axec --skill axec-clean

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove exited axec sessions and their on-disk artifacts that clutter your system after jobs finish, helping reclaim disk space and simplify state management.

Core Features & Use Cases

  • Cleans up session metadata, stdout and stderr logs, and the session directory for exited sessions.
  • Safely preserves running sessions and active work, avoiding disruption.
  • Useful after long-running tasks, batch workflows, or when decommissioning completed jobs.

Quick Start

Run axec clean to remove all exited sessions and their on-disk state.

Frequently Asked Questions about axec-clean

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up exited axec sessions and reclaim disk space?

You can clean up exited axec sessions by running the axec clean command, which removes session metadata, stdout and stderr logs, and the session directory to reclaim disk space.

Does cleaning up axec sessions remove running sessions or active jobs?

No, cleaning up axec sessions safely preserves running sessions and active work, removing only exited sessions and their on-disk artifacts to avoid disrupting current tasks.

How do I get structured output when removing axec session metadata and logs?

You can get structured output when removing axec session metadata and logs by using the --json option with the clean command to emit machine-readable results.

When should I run a bash cleanup workflow to remove session directories and logs?

You should run a bash cleanup workflow to remove session directories and logs after long-running tasks, batch workflows, or when decommissioning completed jobs to ensure only active sessions remain.

What on-disk state does removing exited sessions actually delete?

Removing exited sessions deletes on-disk state including session metadata, stdout and stderr logs, and the session directory, effectively clearing all artifacts left behind after jobs finish.

Can I automate axec cleanup in bash scripts after batch workflows complete?

Yes, you can automate axec cleanup in bash scripts after batch workflows complete by running axec clean, optionally with the --json flag to parse structured output programmatically.