Contact Book
by @ckchzh
Store personal contacts with tags, search, and relationship tracking. Use when adding contacts, searching details, planning follow-ups.
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
add.log, plan.log, tag.log)Data Storage
~/.local/share/contact-book/$DATA_DIR/.log (e.g., add.log, plan.log, remind.log)$DATA_DIR/history.log β master timeline of all activity$DATA_DIR/export. β generated by the export commandRequirements
set -euo pipefail)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 csvView summary statistics
contact-book statsCheck system status
contact-book statusShow 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
contact-book recent for a cross-command activity timelinesearch with shell tools: contact-book search "2025" | grep "plan"prioritize command helps surface your most important relationship-building taskscontact-book help at any time for the complete command referencePowered by BytesAgain | bytesagain.com | hello@bytesagain.com
β‘ When to Use
π‘ 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 csvView summary statistics
contact-book statsCheck system status
contact-book statusShow recent activity
contact-book recent
π Tips & Best Practices
contact-book recent for a cross-command activity timelinesearch with shell tools: contact-book search "2025" | grep "plan"prioritize command helps surface your most important relationship-building taskscontact-book help at any time for the complete command referencePowered by BytesAgain | bytesagain.com | hello@bytesagain.com