session-cleaner

Extract specific turn ranges from Proma session JSONL files and export as Markdown.

2.0k|243|Updated Jan 31, 2026

Search Tags:#session management #data cleaning #Markdown export #AI session analysis #Proma

Ready to run

npx skills add https://github.com/proma-ai/Proma --skill session-cleaner-proma-ai

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: session-cleaner
Source: https://github.com/proma-ai/Proma/tree/main/apps/electron/default-skills/session-cleaner
Command: npx skills add https://github.com/proma-ai/Proma --skill session-cleaner-proma-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of managing large Proma session files, enabling users to extract specific segments, clean data, and generate readable Markdown exports.

Core Features & Use Cases

Session Cleaning: Transform raw session JSONL data into clean, readable Markdown conversations.
Incremental Reading: Support for partial reading of sessions (overviews, outlines, searches, exporting specific turn ranges).
Markdown Export: Export cleaned sessions to Markdown format for easy readability and documentation.
Use Case: For users who need to review specific segments of a long session, extract key information, or create documentation of their Proma interactions.

Quick Start

To clean and export a specific segment of your Proma session, use the 'session-cleaner' skill with the following command: cleaner export <session-id> --turns 5-12.

Frequently Asked Questions about session-cleaner

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

FAQPage Schema

How do I convert Proma session JSONL files into readable Markdown?▼

To convert Proma session JSONL files into readable Markdown, use the session-cleaner to parse and filter raw JSONL data, extracting specific conversation segments and outputting clean Markdown formatted documentation.

Can I extract a specific range of turns from a long AI chat session?▼

Yes, you can extract a specific range of turns from a long AI chat session by using the export command with a turns parameter, allowing incremental reading of specific segments rather than processing the entire file.

Does session-cleaner support partial reading and searching of large JSONL files?▼

Yes, session-cleaner supports partial reading of large JSONL files, offering overviews, outlines, searches, and exporting specific turn ranges to help manage and review long AI-driven chat sessions efficiently.

What is the best way to clean and document specific segments from Proma sessions?▼

The best way to clean and document specific segments from Proma sessions is using a dedicated parsing tool that filters JSONL data and exports the extracted interactions as clean Markdown for administrative documentation.

How to export a specific segment of a Proma session using the command line?▼

To export a specific segment of a Proma session, execute the command 'cleaner export <session-id> --turns 5-12', specifying the session identifier and the desired turn range for extraction.