# ClipBox

> Save and organize reusable text snippets for quick retrieval. Use when storing code fragments, saving command templates, or building snippet libraries.

- Skill: `bytesagain/clipbox` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bytesagain/clipbox`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bytesagain/clipbox/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bytesagain (https://skillmd.com/u/bytesagain)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/bytesagain/clipbox

---


# ClipBox

Developer toolkit for logging, tracking, and exporting entries across multiple categories. Each command records timestamped entries to its own log file. Call without arguments to view recent entries; call with arguments to record a new entry.

## Commands

| Command | What it does |
|---------|-------------|
| `clipbox check <input>` | Record a check entry (no args = show recent) |
| `clipbox validate <input>` | Record a validate entry (no args = show recent) |
| `clipbox generate <input>` | Record a generate entry (no args = show recent) |
| `clipbox format <input>` | Record a format entry (no args = show recent) |
| `clipbox lint <input>` | Record a lint entry (no args = show recent) |
| `clipbox explain <input>` | Record an explain entry (no args = show recent) |
| `clipbox convert <input>` | Record a convert entry (no args = show recent) |
| `clipbox template <input>` | Record a template entry (no args = show recent) |
| `clipbox diff <input>` | Record a diff entry (no args = show recent) |
| `clipbox preview <input>` | Record a preview entry (no args = show recent) |
| `clipbox fix <input>` | Record a fix entry (no args = show recent) |
| `clipbox report <input>` | Record a report entry (no args = show recent) |
| `clipbox stats` | Show summary statistics across all log files |
| `clipbox export <fmt>` | Export all data to json, csv, or txt format |
| `clipbox search <term>` | Search all log entries for a keyword |
| `clipbox recent` | Show the 20 most recent history entries |
| `clipbox status` | Health check — version, entry count, disk usage, last activity |
| `clipbox help` | Show help message |
| `clipbox version` | Show version (v2.0.0) |

## Data Storage

All data is stored locally in `~/.local/share/clipbox/`. Each command writes to its own `.log` file (e.g., `check.log`, `lint.log`). A unified `history.log` tracks all activity with timestamps.

## Requirements

- Bash 4+
- Standard Unix utilities (`wc`, `du`, `tail`, `grep`, `date`, `sed`)

## When to Use

- Logging code checks, lint results, or validation outcomes with timestamps
- Tracking format conversions, diffs, and template usage over time
- Searching historical entries by keyword across all categories
- Exporting accumulated data to JSON, CSV, or plain text for review
- Getting a quick status overview of entry counts and disk usage

## Examples

```bash
# Record a lint finding
clipbox lint "unused variable 'count' in main.py line 42"

# Record a template usage
clipbox template "created new React component from base template"

# Search all logs for "main.py"
clipbox search main.py

# Export everything to JSON
clipbox export json

# View overall stats
clipbox stats

# Check health status
clipbox status
```

---
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com