thisalihassan/claude-plugin/skills/architecture
claude-plugin/skills/architecture/SKILL.md
Architecture guide for the Promptrail CLI. Use when the user asks about how Promptrail works, its data model, CLI commands, or wants to understand the tool before making changes.
$ install --global
skillsauthnpx skillsauth add thisalihassan/promptrail claude-plugin/skills/architectureInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 2:10 AM6.4s1 file scanned
SKILL.md
- description:
- Architecture guide for the Promptrail CLI. Use when the user asks about how Promptrail works, its data model, CLI commands, or wants to understand the tool before making changes.
Promptrail Architecture
CLI tool that reads Claude Code sessions and presents a timeline of prompts with per-prompt file attribution, diffs, search, and rollback.
CLI Commands
promptrail timeline [--files] All prompts with file counts
promptrail diff <n|text> Diff for prompt #n or matching text
promptrail response <n|text> AI response for prompt #n or matching text
promptrail search <query> Full-text search across prompts and responses
promptrail rollback <n|text> Cherry revert prompt's changes
promptrail sessions List all sessions
Filters: --source claude (always use this), --model <substring>
Shortcuts: tl, d, r, rb, s
How Claude Code Data Works
Claude Code JSONL at ~/.claude/projects/<encoded-workspace>/ is self-contained. Each session file has:
- User messages:
role: "human",content[].textcontains the prompt - Assistant messages:
role: "assistant"withcontent[]containing text blocks andtool_useblocks - Tool use blocks:
type: "tool_use"withname(Edit, Write, etc.) andinputcontainingfile_path,old_string,new_string, orcontent - Timestamps: Each message has a real timestamp
No SQLite or file watcher needed -- the JSONL has everything for prompts, file changes, and rollback.
Edit Tools in Claude Code JSONL
| Tool Name | Purpose | Key Fields |
|-----------|---------|------------|
| Edit | String replacement | file_path, old_string, new_string |
| Write | File creation/overwrite | file_path, content |
| MultiEdit | Multiple edits in one call | file_path, edits[] |
Data Flow
SessionReader.readAllTasks()
|-> Parse Claude Code JSONL (prompts + tool_use blocks for file changes)
|-> Returns Task[] sorted chronologically
Each Task has: id, prompt, createdAt, filesChanged, source, model
Key Files
| File | Purpose |
|------|---------|
| src/cli/index.ts | CLI entry point, all commands |
| src/core/session-reader.ts | Parses Claude Code sessions into Task[] |
| src/core/selective-revert.ts | Cherry revert logic (exact string matching) |
| src/models/types.ts | Shared interfaces (Task, FileChange, etc.) |
Platform Paths
| Data | Path |
|------|------|
| Claude sessions | ~/.claude/projects/<workspace>/ |
| Shadow DB | .promptrail/promptrail.db in workspace root |
Known Limitations
- Claude Code rollback uses selective string-matching revert (exact
old_string/new_stringfrom tool calls), not full file before/after snapshots - Hard rollback (Restore Files) is not yet supported for Claude Code sessions
Related Skills
thisalihassan/claude-plugin/skills/timeline
tools
VerifiedTrustedCommunity
Show the timeline of all AI prompts in this project with file change counts. Use when the user asks to see what the AI has done, list prompts, show history, or view the agent timeline.
3SKILL.mdUpdated Apr 17, 2026
thisalihassan/claude-plugin/skills/sessions
tools
VerifiedTrustedCommunity
List all Claude Code sessions for this project. Use when the user asks about sessions, wants to see which sessions exist, or asks about session history.
3SKILL.mdUpdated Apr 17, 2026
thisalihassan/claude-plugin/skills/search
tools
VerifiedTrustedCommunity
Search across all AI prompts and responses using full-text search. Use when the user wants to find a previous conversation, check if they already asked something, or search for a specific topic across sessions.
3SKILL.mdUpdated Apr 17, 2026
thisalihassan/claude-plugin/skills/rollback
tools
VerifiedTrustedCommunity
Rollback (undo) the file changes from a specific AI prompt. Use when the user wants to undo, revert, or rollback changes from a specific prompt. IMPORTANT - this is destructive, always confirm with the user first.
3SKILL.mdUpdated Apr 17, 2026