Rolodex 🗂️

A fast and minimal terminal-based contact manager built in Rust using the Elm architecture, Crossterm, and Ratatui.

Features

• 🧭 Interactive TUI with real-time filtering by name or company
• ⌨️ Keyboard navigation (↑/↓, Home/End)
• 🔍 Search-as-you-type filtering
• 🧵 JSON output for scripting (pipe into jq or CLI dialers)
• 📁 Contact data loaded from contacts.json

Usage

./rolodex | jq -r '.phone'

Use arrow keys to select a contact. Press Enter to emit the contact as JSON, which you can then pipe into another tool.

Keyboard shortcuts

JSON Format

{
  "name": "Alice Anderson",
  "company": "Acme Co.",
  "email": "[email protected]",
  "phone": "0412 345 678"
}

Installation

git clone https://github.com/popplestones/rolodex.git
cd rolodex
cargo build --release

Then run it:

./target/release/rolodex

Development Notes

For planned features like Add/Edit/Delete modes, file persistence, XDG path support, and CLI improvements, see TODO.md. Contributions and ideas welcome!

License

MIT