Contact Book

---
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 remains on disk.

## Commands

| Command | Description |
|---------|-------------|
| `contact-book add <input>` | Add a new contact or entry |
| `contact-book plan <input>` | Record a follow-up plan for a contact |
| `contact-book track <input>` | Log an interaction or touchpoint |
| `contact-book review <input>` | Record a review note for a contact or relationship |
| `contact-book streak <input>` | Track communication streaks with contacts |
| `contact-book remind <input>` | Set a reminder for a contact-related task |
| `contact-book prioritize <input>` | Mark a contact or task as high priority |
| `contact-book archive <input>` | Archive a contact or old entry |
| `contact-book tag <input>` | Add a tag or label to a contact |
| `contact-book timeline <input>` | Record a timeline event for a contact |
| `contact-book report <input>` | Generate a report entry |
| `contact-book weekly-review <input>` | Log a weekly relationship review |
| `contact-book stats` | Show summary statistics: entry counts per command, total, data size |
| `contact-book export <fmt>` | Export all data in `json`, `csv`, or `txt` format |
| `contact-book search <term>` | 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/<command>.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.<fmt>` — 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

```bash
# 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