Vibeleaderboard
← Back to Tools
Index / tool

Clawdex

github.com/openclaw/clawdex
Visit clawdex.sh
Category
Productivity
Rank
No. 1450Tools index

Previous survey · No. 1441 ·

Pricing
Open Source
Type
TOOL
Builder
openclaw
GitHub
53 stars
Latest release
v0.2.2
Date

About

Contacts for Claws — OpenClaw's contact graph that agents can search, add to, and reference across conversations.

What it does

Clawdex is a command-line personal contact archive built around readable Markdown records. It stores people, notes, avatars, and rebuildable indexes locally, with optional private Git backup. It can import several contact sources, search records, show timelines, repair damaged metadata, and export vCards.

Why it's ranked here

Clawdex makes a strong case for engineers who want inspectable, version-controlled contact data. Markdown remains canonical, Git support is explicit, dry runs cover mutating workflows, and repair preserves damaged originals. Its careful local storage model is more complete than its address-book synchronization, which remains preview-only.

What's good

The storage model stays understandable: YAML frontmatter carries structured fields while Markdown holds readable content. Derived email, phone, and handle indexes can be rebuilt. Imports avoid writing back to Apple or Google, avatars require explicit inclusion, manual avatars survive imports, and damaged records receive backups before repair.

Tradeoffs

Clawdex is primarily a CLI, with no repository evidence of a graphical interface, library API, web API, or MCP server. Apple system import only works on macOS and may repeatedly request permission. Google import depends on an external command. Search uses basic substring counting, and remote address-book writes are unavailable.

How to use it well

It fits engineers and agent workflows that value local files, shell automation, JSON output, private Git history, and easy inspection. Use it to consolidate contacts and conversation notes, search context, and produce vCards. Keep another address-book tool for bidirectional Apple or Google synchronization and polished interactive contact management.

Technical notes+

The Go module is declared in go.mod and uses Kong for command parsing plus crawlkit for Git-backed repository operations. internal/cli/cli.go exposes global JSON, plain-text, dry-run, noninteractive, and verbose modes across people, notes, timelines, search, imports, sync previews, export, Git, and repair commands. internal/index/store.go treats per-person Markdown as canonical and rebuilds JSON indexes; its search scores exact text highest, otherwise counts substring occurrences. internal/match/match.go matches imports by external identifier, then normalized email, phone, and name. internal/google/gog.go shells directly to gog, paginates results, and bounds avatar downloads. Platform-specific Apple behavior is split between internal/apple/darwin.go and internal/apple/other.go. internal/vcard/vcard.go writes vCard 4.0 with optional embedded avatars and validates output paths. internal/cli/cli_test.go includes end-to-end command, import, Git, avatar safety, and dry-run coverage.

Observed

Primary language
Go
Interface
Command-line application with JSON and stable plain-text output modes
Installation
Homebrew formula or Go installation from the module command package
Storage
Canonical Markdown with YAML frontmatter, local avatar files, and rebuildable JSON indexes
Platform support
macOS supports direct Apple Contacts import; Linux supports Markdown, notes, search, Git, Google import through gog, and vCard export
Import sources
Apple Contacts, Google Contacts through gog, Birdclaw archives, Discrawl archives, and compatible crawler binaries
Synchronization
Private Git backup is supported; Apple and Google address-book synchronization is preview-only
Testing structure
Repository text includes end-to-end CLI tests covering local commands, imports, Git behavior, avatars, and dry runs

Read from README.md, go.mod, internal/cli/cli.go, internal/repo/git.go, internal/repo/repo.go, internal/google/gog.go, internal/apple/apple.go, internal/apple/other.go, internal/index/store.go, internal/match/match.go, internal/model/types.go, internal/repo/config.go, internal/vcard/vcard.go, internal/apple/darwin.go, internal/cli/cli_test.go.

What it can do

  • Search contacts by name or other criteria

    Search query or contact criteria → List of matching contacts

  • Add new contact to the contact graph

    Contact information (name, details, relationships) → New contact entry in the database

  • Reference existing contacts in conversations

    Contact identifier or name → Contact details retrieved for conversation context

  • Build and maintain contact relationship graph

    Contact data and relationship information → Connected graph of contacts and their relationships

  • Provide contact information to agents across conversations

    Agent request for contact data → Relevant contact information for agent use

Tags

contactsopenclawgraphproductivitycrm

Tech Stack

Go

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.