log-archiver

Archive logs to cloud storage with path-based retention policies and an archive index.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill log-archiver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-archiver
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/logs/skills/log-archiver
Command: npx skills add https://github.com/fractary/claude-plugins --skill log-archiver

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, openssl, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Archives logs to cloud storage with a path-based retention index and a safety net for forgotten logs.

Core Features & Use Cases

  • Path-based retention policies
  • Compress where beneficial
  • Cloud upload and local cleanup
  • Archive index maintenance and GitHub comment posting

Quick Start

Archive logs for a completed work item and update the archive index.

Frequently Asked Questions about log-archiver

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

FAQPage Schema
How do I archive logs to cloud storage with retention policies?

Archive logs by applying path-based retention policies from your project's .fractary/plugins/logs/config.json. The Skill compresses files based on thresholds, uploads them to cloud via fractary-file, maintains an archive index, and verifies uploads before deleting local copies.

Can I compress logs before uploading them to cloud storage?

Yes, log-archiver compresses large files based on configurable thresholds before upload, reducing storage costs and transfer time while preserving the ability to retrieve archived logs from the archive index.

What log types does the archiver support across workflows?

Log-archiver handles session, test, and audit log types across workflows triggered by events like issue_closed, pr_merged, or manual invocation, applying retention rules specific to each log type.

How does path-based retention prevent forgotten logs from accumulating?

Path-based retention policies match log paths to patterns and automatically trigger archival based on scope and conditions defined in your config. An archive index tracks all archived logs, preventing logs from being overlooked during cleanup.

Does log-archiver verify uploads before deleting local files?

Yes, log-archiver verifies successful uploads to cloud before deleting local copies, ensuring no data loss. It maintains the archive index and posts updates to GitHub to track archived content.