scorpiox-conv Session

Conversation management tool following Unix philosophy: simple file operations for managing AI conversation sessions, history, and context.

🐧 Linux x64 🐧 Linux ARM64 🍎 macOS ARM64 🪟 Windows x64

Flags & Options

Flag Short Description Takes Value
--help -h Show help information and usage instructions Yes
--version Display the version number No

Usage Examples

# List all conversation sessions
$ scorpiox-conv
conv-001 2026-03-12 14:30 claude "Refactor auth module"
conv-002 2026-03-12 15:10 openai "Debug network stack"
conv-003 2026-03-13 09:45 claude "Write unit tests"
# Show conversation details by ID
$ scorpiox-conv conv-001
Session: conv-001
Provider: claude
Started: 2026-03-12 14:30:22
Messages: 42
Tokens: 18,340
Status: active
# Pipe conversation context to another tool
$ scorpiox-conv conv-001 | scorpiox-transcript --format md
→ transcript_conv-001.md written (42 messages)
# Use with scorpiox-rewind to restore a session checkpoint
$ scorpiox-conv conv-002 | scorpiox-rewind --to 15
→ Session rewound to message 15 of 38
# Display help
$ scorpiox-conv --help
# Check installed version
$ scorpiox-conv --version
scorpiox-conv 1.0.0 (6cf2eaf)

Source & Build Info

Source File
scorpiox/scorpiox-conv.c
Lines of Code
253
Dependencies
libsxutil
Category
session

Related Tools