syncropel-cli

The spl command — Syncropel's CLI for inspecting traces, querying VFS, and managing configuration.

Install

pip install syncropel-cli
# or
uv pip install syncropel-cli

Quick Start

# List recent sessions
spl trace ls

# Show effects in the last session
spl trace show last

# Show effects in a specific session (prefix match)
spl trace show 3000672e

# Aggregate stats across all sessions
spl trace stats

# Extract workflow patterns
spl trace pattern last

# Show high-risk operations
spl trace risk

# Show configuration
spl config show

Trace Commands

Command	What it does
spl trace ls	List recent sessions with effect counts and success rates
spl trace show <session>	Show all effects in a session with VFS addresses and shell analysis
spl trace stats	Aggregate statistics across sessions (primitives, categories, risks)
spl trace pattern <session>	Extract workflow patterns (read-edit pairs, git workflow, phases)
spl trace risk	Find high-risk operations across sessions

All trace commands support --output json for machine-readable output and --integration to filter by integration (e.g., claude-code).

Data Source

Reads trace files from ~/.syncropel/traces/{integration}/. These are produced by Syncropel integrations like the Claude Code tracer.

Environment Variables

Variable	Default	Description
SPL_HOME	~/.syncropel	Syncropel home directory

Requirements

• Python 3.12+
• Traces produced by a Syncropel integration

License

Apache-2.0