Quick Start

First run

allman login                       # opens browser, saves session
allman sync                        # pull conversation history
allman conversations               # list your conversations
allman messages jamie-rivera       # read a thread
allman send jamie-rivera "Hey!"    # send a message
allman listen                      # stream real-time events as NDJSON

What happens during login

allman login opens a real Chromium browser window. Log into LinkedIn as you normally would. Once authenticated, allman captures your session cookies and saves them locally. No credentials are ever sent anywhere except to LinkedIn.

What happens during sync

allman sync pulls your conversation history from LinkedIn into local JSONL files:

• Fetches your conversation list
• Downloads messages for each conversation
• Resolves each contact’s LinkedIn slug via the profile API
• Stores everything in .allman/ as JSON and JSONL files
• Commits the store to git

By default, sync pulls messages since the last sync. On first run, it goes back 90 days.

Using the TUI

allman-tui

Navigate with j/k, press Enter to open a conversation, i to compose, / to search, ? for full help.

Piping to agents

Every command supports --json for structured output:

# Get new messages as JSON
allman inbox --json

# Stream live events
allman listen --json | while read -r event; do
  echo "Got: $event"
done

# Search and pipe
allman search "jamie" --json | jq '.[] | .slug'