🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Contact Book

by @ckchzh

Store personal contacts with tags, search, and relationship tracking. Use when adding contacts, searching details, planning follow-ups.

Versionv2.0.1
Downloads606
Installs1
Stars⭐ 2
TERMINAL
clawhub install contact-book

πŸ“– About This Skill


version: "2.0.0" name: contact-book description: "Store personal contacts with tags, search, and relationship tracking. Use when adding contacts, searching details, planning follow-ups." author: BytesAgain homepage: https://bytesagain.com source: https://github.com/bytesagain/ai-skills

Contact Book

Productivity toolkit for managing contacts and relationships β€” add entries, plan follow-ups, track interactions, set reminders, tag contacts, and generate reports. All data stays local.

Commands

| Command | Description | |---------|-------------| | contact-book add | Add a new contact or entry | | contact-book plan | Record a follow-up plan for a contact | | contact-book track | Log an interaction or touchpoint | | contact-book review | Record a review note for a contact or relationship | | contact-book streak | Track communication streaks with contacts | | contact-book remind | Set a reminder for a contact-related task | | contact-book prioritize | Mark a contact or task as high priority | | contact-book archive | Archive a contact or old entry | | contact-book tag | Add a tag or label to a contact | | contact-book timeline | Record a timeline event for a contact | | contact-book report | Generate a report entry | | contact-book weekly-review | Log a weekly relationship review | | contact-book stats | Show summary statistics: entry counts per command, total, data size | | contact-book export | Export all data in json, csv, or txt format | | contact-book search | Search across all logs for a keyword | | contact-book recent | Show the 20 most recent activity entries | | contact-book status | Health check: version, data dir, entry count, disk usage, last activity | | contact-book help | Show help with all available commands | | contact-book version | Show current version |

Command Behavior

  • With arguments: Each command logs the input with a timestamp to its own dedicated log file (e.g., add.log, plan.log, tag.log)
  • Without arguments: Each command displays the 20 most recent entries from its respective log file
  • Data Storage

  • Default data directory: ~/.local/share/contact-book/
  • Per-command logs: $DATA_DIR/.log (e.g., add.log, plan.log, remind.log)
  • History log: $DATA_DIR/history.log β€” master timeline of all activity
  • Export files: $DATA_DIR/export. β€” generated by the export command
  • All data is local plain-text. No cloud, no sync, no network calls.
  • Requirements

  • Bash 4+ (uses set -euo pipefail)
  • No external dependencies or API keys required
  • Works entirely offline β€” your data stays on your machine
  • When to Use

    1. Building a personal CRM β€” Use add, tag, and track to maintain a lightweight contact database with interaction history 2. Planning follow-ups β€” Use plan and remind to schedule and track outreach to important contacts 3. Maintaining communication streaks β€” Track how consistently you stay in touch with key people using streak 4. Weekly relationship reviews β€” Run weekly-review to reflect on your networking activity and identify gaps 5. Exporting contact data β€” Use export json or export csv to produce structured data for other tools or spreadsheets

    Examples

    # Add a new contact
    contact-book add "Alice Chen β€” PM at Acme Corp β€” alice@acme.com"

    Plan a follow-up

    contact-book plan "Follow up with Alice re: partnership proposal by Friday"

    Track an interaction

    contact-book track "Had coffee with Bob, discussed Q2 roadmap"

    Tag a contact

    contact-book tag "Alice Chen: investor, priority"

    Set a reminder

    contact-book remind "Send birthday card to Carol β€” March 25"

    Log a weekly review

    contact-book weekly-review "Reached out to 5 contacts, 3 replied, 1 meeting scheduled"

    Search across all logs

    contact-book search "Alice"

    Export all data as CSV

    contact-book export csv

    View summary statistics

    contact-book stats

    Check system status

    contact-book status

    Show recent activity

    contact-book recent

    How It Works

    Each command maintains its own log file in the data directory. Entries are stored as timestamp|value lines. The stats command aggregates counts across all log files. The export command merges all logs into a single file in your chosen format (JSON, CSV, or TXT). Every action is also recorded in history.log as a master audit trail.

    Tips

  • Run any command without arguments to review its recent entries β€” quick way to check history
  • Use contact-book recent for a cross-command activity timeline
  • Combine search with shell tools: contact-book search "2025" | grep "plan"
  • The prioritize command helps surface your most important relationship-building tasks
  • Run contact-book help at any time for the complete command reference

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

    ⚑ When to Use

    TriggerAction
    2. **Planning follow-ups** β€” Use `plan` and `remind` to schedule and track outreach to important contacts
    3. **Maintaining communication streaks** β€” Track how consistently you stay in touch with key people using `streak`
    4. **Weekly relationship reviews** β€” Run `weekly-review` to reflect on your networking activity and identify gaps
    5. **Exporting contact data** β€” Use `export json` or `export csv` to produce structured data for other tools or spreadsheets

    πŸ’‘ Examples

    # Add a new contact
    contact-book add "Alice Chen β€” PM at Acme Corp β€” alice@acme.com"

    Plan a follow-up

    contact-book plan "Follow up with Alice re: partnership proposal by Friday"

    Track an interaction

    contact-book track "Had coffee with Bob, discussed Q2 roadmap"

    Tag a contact

    contact-book tag "Alice Chen: investor, priority"

    Set a reminder

    contact-book remind "Send birthday card to Carol β€” March 25"

    Log a weekly review

    contact-book weekly-review "Reached out to 5 contacts, 3 replied, 1 meeting scheduled"

    Search across all logs

    contact-book search "Alice"

    Export all data as CSV

    contact-book export csv

    View summary statistics

    contact-book stats

    Check system status

    contact-book status

    Show recent activity

    contact-book recent

    πŸ“‹ Tips & Best Practices

  • Run any command without arguments to review its recent entries β€” quick way to check history
  • Use contact-book recent for a cross-command activity timeline
  • Combine search with shell tools: contact-book search "2025" | grep "plan"
  • The prioritize command helps surface your most important relationship-building tasks
  • Run contact-book help at any time for the complete command reference

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