Skip to content
allman

Introduction

allman is a CLI and terminal UI that syncs your LinkedIn conversations to your machine. Read, search, reply, and pipe messages to AI agents — all from your terminal.

What is allman?

Section titled “What is allman?”

allman consists of two tools:

  • allman CLI — sync, search, send, listen, and manage your LinkedIn messages from the command line. Every command supports --json for piping to scripts and AI agents.
  • allman-tui — a full terminal inbox with vim-style navigation, live updates, emoji reactions, and keyboard-driven workflows.

Design principles

Section titled “Design principles”

Local-first

Section titled “Local-first”

Messages are stored as plain JSONL files in a local git repository. Nothing is sent to any server. Your data stays on your machine.

AI-native

Section titled “AI-native”

NDJSON event streams, structured JSON output, and a scriptable CLI. Built for agents that manage your conversations.

Keyboard-driven

Section titled “Keyboard-driven”

Full terminal UI with vim bindings, inline search, emoji reactions, and everything you need without leaving the terminal.

How it works

Section titled “How it works”
  1. Authenticate via a real browser session (Playwright Chromium). Your cookies stay local.
  2. Sync pulls your conversation history into local JSONL files.
  3. Read, search, reply from the CLI or TUI. All reads come straight from disk — fast and offline-capable.
  4. Listen streams real-time events (messages, reactions, typing indicators) as NDJSON.
  5. Send replies with pre-send safety checks and built-in rate limiting.

Next steps

Section titled “Next steps”