pwn-sessions

Drive PWN::Sessions from pwn_eval.

SKILL.md

GitHub

PWN::Sessions

PWN::Sessions provides session management for pwn-ai (and other drivers) — list, resume, transcripts, and stats. Sessions are stored as JSONL transcripts in ~/.pwn/sessions/ for durability and easy search/append. pwn-ai agent mode auto-creates and appends to a session on each activation.

When to use

Call PWN::Sessions from pwn_eval when the task needs this module. Do not reimplement it in shell.

Methodologies

Generated from pwn/sessions.rb. Prefer the public class methods below. Class methods take (opts = {}) and read opts.

How to call

PWN::Sessions.help
PWN::Sessions.sessions_dir(opts)

Public methods

  • sessions_dir
  • list
  • dependency_index
  • activate
  • deactivate
  • active
  • create
  • metadata
  • title_status
  • resolve
  • provisional_title
  • refresh_title
  • append
  • load
  • previous_id
  • recall
  • to_response_history
  • to_llm_messages
  • delete
  • stats
  • lean
  • protected_session_ids
  • export
  • retain
  • redact
  • authors
  • help
  • active?
  • lean!

Source

pwn/sessions.rb

Verification

PWN::Sessions.respond_to?(:sessions_dir) after the module is loaded. Read the source for parameter names.