Logbook
by @ckchzh
Write journal entries, search history, and export your personal log digitally. Use when journaling thoughts, searching past entries, exporting notes.
clawhub install logbookπ About This Skill
name: LogBook version: "2.0.0" author: "BytesAgain" homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills tags: ["journal","diary","log","daily","writing","personal","productivity","notes"] categories: ["Personal Management", "Productivity", "Writing"] description: "Write journal entries, search history, and export your personal log digitally. Use when journaling thoughts, searching past entries, exporting notes."
LogBook
LogBook is a data processing and analysis toolkit for querying, importing, exporting, transforming, validating, and visualizing datasets from the terminal. It provides 10 core commands for working with structured data, plus built-in history logging and a quick dashboard view. All operations are local β no external APIs, databases, or network connections required.
Commands
| Command | Description |
|---------|-------------|
| logbook query | Query data from the local data store. Logs the query action to history for auditing. |
| logbook import | Import a data file into the local store. Accepts any file path as input. |
| logbook export | Export processed results to a specified destination (defaults to stdout). |
| logbook transform | Transform data from one format or structure to another. |
| logbook validate | Validate data against the built-in schema. Reports schema compliance status. |
| logbook stats | Display basic statistics β total record count from the data log. |
| logbook schema | Show the current data schema. Default fields: id, name, value, timestamp. |
| logbook sample | Preview the first 5 records from the data store, or "No data" if the store is empty. |
| logbook clean | Clean and deduplicate the data store, removing redundant entries. |
| logbook dashboard | Quick dashboard showing total record count and summary metrics. |
| logbook help | Show help with all available commands and usage information. |
| logbook version | Print version string (logbook v2.0.0). |
Data Storage
All data is stored locally in ~/.local/share/logbook/ (override with LOGBOOK_DIR or XDG_DATA_HOME environment variables).
Directory structure:
~/.local/share/logbook/
βββ data.log # Main data store (line-based records)
βββ history.log # Unified activity log with timestamps
Every command logs its action to history.log with a timestamp (MM-DD HH:MM) for full traceability. The main data file data.log holds all imported and processed records.
Requirements
set -euo pipefail)date, wc, head, du, echoLOGBOOK_DIR environment variable to customize the data directory locationWhen to Use
1. Importing and querying datasets β Pull in CSV, log, or structured data files and run quick queries against them from the terminal without needing a full database setup.
2. Data validation workflows β Validate incoming data against the built-in schema (id, name, value, timestamp) before processing to catch format issues early.
3. Data transformation pipelines β Transform data between formats or structures as part of an ETL-like workflow, all within a lightweight bash script.
4. Quick dashboard and statistics β Get instant record counts and summary metrics via dashboard or stats without writing custom aggregation scripts.
5. Data cleanup and deduplication β Use clean to remove duplicate records and normalize the data store before exporting or feeding into downstream analysis.
Examples
# Import a data file
logbook import transactions.csvQuery the data store
logbook query "status=active"View the data schema
logbook schemaPreview first 5 records
logbook sampleGet basic statistics (record count)
logbook statsTransform data between formats
logbook transform raw.csv cleaned.csvValidate data integrity against schema
logbook validateQuick dashboard view
logbook dashboardExport results
logbook export results.jsonClean and deduplicate the data store
logbook cleanShow version
logbook version
Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| LOGBOOK_DIR | Custom data directory path | ~/.local/share/logbook |
| XDG_DATA_HOME | XDG base data directory (fallback) | ~/.local/share |
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com
β‘ When to Use
π‘ Examples
# Import a data file
logbook import transactions.csvQuery the data store
logbook query "status=active"View the data schema
logbook schemaPreview first 5 records
logbook sampleGet basic statistics (record count)
logbook statsTransform data between formats
logbook transform raw.csv cleaned.csvValidate data integrity against schema
logbook validateQuick dashboard view
logbook dashboardExport results
logbook export results.jsonClean and deduplicate the data store
logbook cleanShow version
logbook version