Clean Log Toolkit
Local log file inspection and analysis toolkit. Parse common log formats (apache-common, apache-combined, nginx-access, syslog, JSON-line) or custom regex wi... Skill: Clean Log Toolkit Owner: gopendrasharma89-tech Summary: Local log file inspection and analysis toolkit. Parse common log formats (apache-common, apache-combined, nginx-access, syslog, JSON-line) or custom regex wi... Tags: agent:0.2.0, apache:0.2.0, errors:0.2.0, follow:0.2.0, grep:0.2.0, json-line:0.1.0, latest:0.2.0, live:0.2.0, log:0.2.0, nginx:0.2.0, observability:0.2.0, parse:0.2.0, stdlib:0.2.0, syslog:0
Rank
62
Safety
84
Downloads
954
Updated
Oct 12, 2026
Version
0.2.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 954 downloads reported by the source. Last updated 10/12/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 12, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 12, 2026
- Adoption signal
- 954 downloadsadoption · observed Oct 12, 2026
- Latest release
- 0.2.0release · observed Jun 4, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 0.2.0release
v0.2.0: Add scripts/follow.py - tail -F equivalent for live log monitoring, log-aware. Streams new lines as they arrive with the same --pattern / --not-pattern / --level / --since filters as grep.py. Automatic log-rotation detection (inode change or file truncation triggers transparent reopen). --max-events N exits cleanly after N matched events (CI-friendly), --timeout SECONDS exits on inactivity, --json emits per-line JSON envelopes with extracted timestamp + level. Closes the only documented limitation from v0.1.x ('It does not tail/follow live log files').
Observed Jun 4, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s17cp87fy279ggwne1mqcb6675843tdy:clean-log-toolkit- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
39,557 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: clean-log-toolkit
description: Local log file inspection and analysis toolkit. Parse common log formats (apache-common, apache-combined, nginx-access, syslog, JSON-line) or custom regex with named groups into structured TSV/CSV/JSONL. Aggregate errors by level and time bucket (minute/hour/day), surface the most common error groups via fingerprint normalization, and produce JSON/Markdown/CSV reports. Grep log lines with optional time-window (--since/--until), level filter, named-group regex, and -B/-A/-C context lines. Pure Python 3 standard library, no third-party dependencies, no remote calls.
license: MIT
metadata: {"openclaw":{"requires":{"bins":["python3"]},"primaryEnv":null,"homepage":"https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit"}}
---
# clean-log-toolkit
v0.2.0
A small, honest local toolkit for the work agents end up doing constantly: read a log someone sent you, figure out the format, find the actual problems, and produce a summary you can paste into a ticket. Built on Python 3 standard library only. No `awk`/`sed`/`jq` wrappers, no pip installs, no remote calls.
This skill is the third of the "clean-*" trio:
- [`clean-csv-toolkit`](https://clawhub.ai/gopendrasharma89-tech/clean-csv-toolkit) — structured tabular data
- [`clean-text-toolkit`](https://clawhub.ai/gopendrasharma89-tech/clean-text-toolkit) — unstructured text
- **`clean-log-toolkit`** — semi-structured timestamped logs
## What this skill does
- `scripts/parse.py` — parse a log file into structured rows. Auto-detects `apache-common`, `apache-combined`, `nginx-access`, `syslog`, and `json-line` formats by sniffing the first ~50 lines. Falls back to a generic timestamp + level + message extractor when nothing matches. Pass `--regex PATTERN` with named groups to define a custom format. Output as `.csv`, `.tsv`, or `.jsonl`.
- `scripts/errors.py` — aggregate the errors in a log file. Counts by level (WARN / ERROR / FATAL by default), buckets the timeline by minute / hour / day, normalizes each message into a "fingerprint" (replaces numbers, UUIDs, hex tokens, file:line pairs, and embedded timestamps with placeholders) and surfaces the top-N most frequent error groups. Writes a JSON / Markdown / CSV report or prints a one-screen summary.
- `scripts/grep.py` — grep, but log-aware. Combine `--pattern REGEX`, `--not-pattern REGEX`, `--level LVL[,LVL2...]`, `--since TIMESTAMP`, `--until TIMESTAMP`, and `-B / -A / -C` context lines into one filter pass.
- `scripts/follow.py` (NEW in v0.2.0) — `tail -F` equivalent, log-aware. Streams new lines as they arrive with the same `--pattern` / `--not-pattern` / `--level` / `--since` filters as `grep.py`. Detects log rotation automatically (inode change or file truncation reopens the file). `--max-events N` exits cleanly after N matched events (CI-friendly); `--timeout SECONDS` exits on inactivity; `--json` emits per-line envelopes with extracted timestamp + level.
- `scripts/check_deps.sh` — verify `python3` is avail_meta.json
{
"ownerId": "kn7fkwsa5knkdkkachj1p7rwr9843xts",
"slug": "clean-log-toolkit",
"version": "0.2.0",
"publishedAt": 1780595835710
}skill-card.md
## Description: Clean Log Toolkit helps agents inspect local log files by parsing common formats, aggregating errors, filtering by pattern, time, level, and context, following live logs, and producing structured reports without third-party dependencies or remote calls. This skill is ready for commercial/non-commercial use. ## Publisher: [gopendrasharma89-tech](https://clawhub.ai/user/gopendrasharma89-tech) ### License/Terms of Use: MIT ## Use Case: Developers, support engineers, and agents use this skill to inspect local log files, convert logs into structured outputs, find error clusters, filter incident windows by time, level, and pattern, and prepare reports for tickets or downstream analysis. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Output files can overwrite source logs or symlink aliases, which can cause data loss. Mitigation: Use a separate output directory and confirm output paths are not the original log path or a symlink to it before running parse, grep, or error-report commands. Risk: Generated reports can preserve sensitive raw log content. Mitigation: Inspect and redact reports before sharing them in tickets, repositories, spreadsheets, or chat. ## Reference(s): - [Clean Log Toolkit ClawHub skill page](https://clawhub.ai/gopendrasharma89-tech/skills/clean-log-toolkit) - [Clean Log Toolkit ClawHub homepage](https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit) - [Related Clean CSV Toolkit](https://clawhub.ai/gopendrasharma89-tech/clean-csv-toolkit) - [Related Clean Text Toolkit](https://clawhub.ai/gopendrasharma89-tech/clean-text-toolkit) ## Skill Output: **Output Type(s):** [text, markdown, JSON, CSV, TSV, JSONL, shell commands, guidance] **Output Format:** [Plain text summaries, filtered log lines, Markdown reports, JSON reports, CSV/TSV tables, JSONL rows, and shell command examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces local stdout output or files at caller-provided paths; follow.py can stream matched lines as JSON envelopes.] ## Skill Version(s): 0.2.0 (source: release metadata and SKILL.md body) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
LICENSE
MIT License Copyright (c) 2026 gopendrasharma89-tech Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
- Proof JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/gopendrasharma89-tech/skills/clean-log-toolkit",
"sourceUrl": "https://clawhub.ai/gopendrasharma89-tech/skills/clean-log-toolkit",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T02:32:01.884Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T02:32:01.884Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "954 downloads",
"href": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceUrl": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T02:32:01.884Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.2.0",
"href": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceUrl": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-04T17:57:15.710Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.2.0",
"description": "v0.2.0: Add scripts/follow.py - tail -F equivalent for live log monitoring, log-aware. Streams new lines as they arrive with the same --pattern / --not-pattern / --level / --since filters as grep.py. Automatic log-rotation detection (inode change or file truncation triggers transparent reopen). --max-events N exits cleanly after N matched events (CI-friendly), --timeout SECONDS exits on inactivity, --json emits per-line JSON envelopes with extracted timestamp + level. Closes the only documented limitation from v0.1.x ('It does not tail/follow live log files').",
"href": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceUrl": "https://clawhub.ai/gopendrasharma89-tech/clean-log-toolkit",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-04T17:57:15.710Z",
"isPublic": true
}
]
}Record generated Oct 13, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements, proof.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-gopendrasharma89-tech-clean-log-toolkit/run-check
