beeper-intel

Intelligence dashboard for the Beeper messaging ecosystem
Repos, APIs, bridges, community tools, and strategic signals -- all in one place.

---

Executive Summary

AgentRemote: The AI Pivot Beeper renamed ai-bridge to agentremote -- "All your agents in Beeper." Codex, OpenClaw, and OpenCode bridges connect AI agent runtimes directly into Beeper chat with full history, streaming, and tool approvals. 3 bridges near ready for testing (Mar 6, 2026)	AI Chats: Imminent Built-in AI chat capability "coming very soon" (Mar 4, 2026). Image forwarding for questions and image descriptions planned. Translation feature already running in nightlies for 2 months, unreleased.
11 Documentation Gaps Cross-referencing the official docs with 13,072 community messages reveals 11 significant gaps: no REST API reference page (404), undocumented WebSocket events, zero docs for AI features, AgentRemote, headless mode, or webhooks.	Ecosystem Scale 125 official repos, 35+ community projects, 6 SDKs, 13 bridges, 9 supported MCP clients, 21 API endpoints. Desktop API grew 75% in 4 months.

---

Ecosystem Map

graph TB
    subgraph core["Beeper Apps"]
        BD["Desktop"]
        BA["Android"]
        BI["iOS"]
    end

    subgraph api["Desktop API"]
        REST["REST /v1<br/>21 endpoints"]
        MCP["MCP Server<br/>10 tools"]
        WS["WebSocket<br/>/v1/ws"]
    end

    subgraph sdks["SDKs"]
        TS["TypeScript<br/>v4.5.0"]
        PY["Python<br/>v4.1.296"]
        GOL["Go v0.4.0"]
        GCLI["CLI v0.2.0"]
        GPHP["PHP"]
        GSQL["SQL"]
    end

    subgraph clients["MCP Clients (9)"]
        C1["Claude Desktop"]
        C2["Claude Code"]
        C3["Cursor"]
        C4["VS Code"]
        C5["Raycast"]
        C6["Warp / Codex / Gemini CLI"]
    end

    subgraph bridges_off["Official Bridges (13)"]
        B1["WhatsApp"]
        B2["Telegram"]
        B3["Signal"]
        B4["Meta (FB+IG)"]
        B5["Discord"]
        B6["Slack"]
        B7["LinkedIn"]
        B8["iMessage"]
        B9["X / Twitter"]
        B10["Google Msgs/Chat/Voice"]
        B11["Bluesky"]
    end

    subgraph agents["AgentRemote"]
        A1["Codex Bridge"]
        A2["OpenClaw Bridge"]
        A3["OpenCode Bridge"]
    end

    subgraph community["Community (35+)"]
        T1["beepctl (30*)"]
        T2["docker-beeper (56*)"]
        T3["Metrology theme (41*)"]
    end

    BD --> REST & MCP & WS
    REST --> TS & PY & GOL & GCLI & GPHP & GSQL
    MCP --> C1 & C2 & C3 & C4 & C5 & C6
    BD -.-> bridges_off
    BD -.-> agents
    TS --> T1
    REST --> T2

    style core fill:#1a1b27,color:#c0caf5,stroke:#7aa2f7
    style api fill:#1a1b27,color:#c0caf5,stroke:#bb9af7
    style sdks fill:#1a1b27,color:#c0caf5,stroke:#7dcfff
    style clients fill:#1a1b27,color:#c0caf5,stroke:#9ece6a
    style bridges_off fill:#1a1b27,color:#c0caf5,stroke:#ff9e64
    style agents fill:#1a1b27,color:#c0caf5,stroke:#f7768e
    style community fill:#1a1b27,color:#c0caf5,stroke:#e0af68

Loading

Full interactive diagram with all 160+ repos: reports/ecosystem-map.md

---

GitHub Ecosystem

Top Official Repositories

Stars	Repository	Language	Description	Last Active
1290	bridge-manager		Self-hosted bridge management	Mar 2026
1065	self-host	-	Self-hosting docs
1032	imessage		iMessage bridge
629	beepy		Beepy hardware device	Mar 2026
156	themes		Community CSS themes	Mar 2026
150	mac-registration-provider		iMessage Mac registration	-
70	barcelona		iMessage framework	-
56	docker-beeper		Desktop in browser (community)	-
32	aibot		ChatGPT bot for Matrix	-
30	beepctl		CLI tool (community)	Mar 2026

Very Active Repos (daily/weekly commits)

Repository	Stars	Language	Activity	Updated
platform-imessage	1	Swift	Daily	Mar 9, 2026
agentremote	11	Go	Daily	Mar 9, 2026
metabase	0	Clojure	Daily	Mar 9, 2026
desktop-api-js	21	TypeScript	Weekly	Mar 8, 2026
desktop-api-cli	5	Go	Weekly	Mar 8, 2026
chat-adapter-matrix	12	TypeScript	Weekly	Mar 8, 2026
bridge-manager	1290	Go	Weekly	Mar 6, 2026
desktop-api-openapi	-	YAML	Weekly	Mar 6, 2026

Archived Repos (8)

Repository	Stars	Reason
self-host	1065	Docs moved to developers.beeper.com
imessage	1032	Replaced by platform-imessage (Swift)
linkedin	102	Merged into mautrix/linkedin
linkedin-messaging-api	61	Deprecated, moved to linkedin repo
sdk-docs	42	Docs moved to developers.beeper.com
synapse-legacy-fork	7	Old Synapse fork no longer needed
mautrix-go	3	Superseded by mautrix org
signald	2	Old Signal bridge replaced

---

API Timeline

Desktop API Evolution

Version	Date	Endpoints Added	Highlight
v4.1.294	Oct 16, 2025	~12	Major migration: gRPC /v0 to REST /v1
v4.2.499	Jan 23, 2026	+3	Message editing, file uploads
v4.2.509	Jan 27, 2026	+1	Asset serving with range requests
v4.2.557	Feb 13, 2026	+6	WebSocket, reactions, discovery, contacts
		= 21	+75% growth in 4 months

Current Endpoint Map

/v1/info                                          GET    Discovery
/v1/accounts                                      GET    List accounts
/v1/accounts/{id}/contacts/list                   GET    List contacts
/v1/chats                                         GET    List/search chats
/v1/chats                                         POST   Create chat
/v1/chats/{id}                                    GET    Get chat details
/v1/chats/{id}/archive                            PUT    Archive/unarchive
/v1/chats/{id}/reminder                           PUT    Set reminder
/v1/chats/{id}/messages                           GET    List messages
/v1/chats/{id}/messages                           POST   Send message
/v1/chats/{id}/messages/{mid}                     PUT    Edit message
/v1/chats/{id}/messages/{mid}/reactions            POST   Add reaction
/v1/chats/{id}/messages/{mid}/reactions            DELETE Remove reaction
/v1/search                                        GET    Unified search
/v1/search/users                                  GET    Search contacts
/v1/assets/upload                                 POST   Upload (multipart)
/v1/assets/upload/base64                          POST   Upload (base64)
/v1/assets/serve                                  GET    Stream asset
/v1/ws                                            GET    WebSocket events
/v1/open                                          POST   Focus app window
/v0/mcp                                           POST   MCP endpoint

Full version-by-version changelog: timelines/api-evolution.md

---

Desktop Changelog

v4.2.630 -- Mar 9, 2026

New: Search bar in Settings window

Fixes:

• iMessage reactions fixed on macOS Tahoe and Sequoia
• Performance improvements for faster chat catchup on launch
• Fixed missing names/avatars for chat participants
• Fixed unread count bugs and chats in wrong space after sidebar redesign
• Remind Me correctly uses "If no reply" default setting
• Fixed broken icons on Windows and Linux
• Fixed incomplete contact list when creating group Google Messages chats

v4.2.605 -- Mar 3, 2026

New: Redesigned account filters and sidebar (Space Bar)

Fixes:

• Multi-message forwarding restored
• Display name issues resolved
• Windows/Linux "Beeper is already running" warning fixed
• Image rotation direction fixed
• On-Device Telegram connection improvements for clock sync issues

v4.2.587 -- Feb 24, 2026

Fixes:

• Storage management shows accurate disk recovery calculations
• Warning for installing newer version while older running
• Location messages fully deleted on removal
• Menubar functionality fixed
• Signal replies, reactions, sent messages working for all users
• Old message deletion for Instagram and Facebook chats

v4.2.564 -- Feb 17, 2026

New: Disk usage management via Settings > Storage

Fixes:

• Emoji rendering on Macs with Lockdown Mode
• Picture-in-Picture video improvements
• Telegram login retry for failed 2FA
• iMessage chat archiving enhanced
• Extra windows on launch eliminated
• Messenger audio message transcription fixed

---

Documentation Gaps

11 gaps identified between shipped features and official documentation:

#	Area	Severity	Status	Impact
7	Webhooks		Not built yet	Real-time integrations blocked
1	REST API Reference		404 page	No unified endpoint docs
2	WebSocket Events		Undocumented	Must reverse-engineer events
5	AI Features		Imminent, no docs	Can't prepare integrations
6	AgentRemote		Daily commits, no docs	Invisible to developers
8	Headless Mode		In development	Server deployment impossible
3	MCP Tools List		Incomplete	Must discover at runtime
4	Translations		In nightly ~2 months	Users unaware
9	Send-Later API		App-only	No API scheduling
10	Python SDK Install		SSH-only	High friction
11	Dynamic Changelog		JS-dependent	Can't scrape

Full analysis with evidence: reports/documentation-gaps.md

---

Community Projects

CLI Tools & SDKs

Project	Author	Stars	Language	Description
beepctl	blqke	30		CLI for messaging from terminal
beeper-cli	KrauseFx	25		Read-only browse/search
BeeperPS	AndrewPla	8		PowerShell module
desktop-api-cli	beeper	5		Official CLI v0.2.0

MCP Servers

Project	Author	Stars	Description
desktop-api-mcp	beeper	3	Claude Desktop Extension (official)
mcp-android	beeper	8	Android MCP server (official)
poke-beeper-proxy	keithah	1	macOS MCP tunnel daemon
beeper-mcp	mimen	0	Python MCP server
beeper-mcp-server	stopWarByWar	1	Python MCP server

Themes

Theme	Author	Stars	Style
Metrology-for-Beeper	Madelena	41	Flat Metro design
beeper-custom-css	clins1994	11	Custom CSS styles
beeper-midnight	JaxonWright	8	Pitch-black theme
beeper-icons-theme	MoralesJonathan	5	Full color social icons
Beeper-WinUI-Theme	highesttt	4	WinUI 3 theme

Infrastructure & Tools

Project	Author	Stars	Description
docker-beeper	zachatrocity	56	Desktop in browser via Docker
beeper-bridges	rhinot	16	Docker Compose for bridges
Beeper-install	nzxlabs	8	Easy-install scripts
beepex	johnburnett	3	Chat history export
update-beeper	beeper-community	1	Self-healing Linux updater
awesome-beeper	robertogogoni	1	Community docs & changelogs

Community Bridges

Bridge	Author	Stars	Network
imessage	lrhodin	23	iMessage v2 (Rust)
matrix-line-messenger	highesttt	14	LINE
snapchat-bridge	lalomorales22	1	Snapchat
zalo-beeper-bridge	lequocbinh04	0	Zalo

---

Strategic Signals

🤖 AgentRemote Confidence: Beeper is building a platform for AI agents inside chat. The agentremote repo contains bridges for Codex, OpenClaw, and OpenCode. Renamed from ai-bridge in early 2026. Gets daily commits. "3 bridges very close to ready for testing" -- batuhan, Mar 6 Deep dive	🔮 AI Chats Confidence: Built-in AI chat feature coming to Beeper. Forward images for questions, image descriptions planned. Translation feature already silently running in nightlies for 2+ months. "Coming very soon" -- batuhan, Mar 4
🖥️ Headless Mode Confidence: Headless/hostable Desktop API without GUI, enabling server deployments with decryption and webhooks. Currently requires Docker + full desktop app workaround (docker-beeper, 56 stars). "Working on headless/hostable Desktop API" -- batuhan, Dec 2025	🔔 Webhooks (#1 Request) Confidence: The most requested developer feature. WebSocket events (v4.2.557) serve as partial substitute but lack documentation. Webhooks expected to ship alongside headless mode. "#1 community request" -- batuhan, Dec 2025
🔌 MCP Everywhere Confidence: MCP is the primary AI interface: 9 supported clients, built-in server in Desktop, Claude Desktop Extension, Android MCP server. Every AI-powered IDE can access Beeper chat data.	💰 Bridge Bounties ($50K) Confidence: Up to $50,000 bounties for new bridges. Target networks: WeChat, Snapchat, Teams, Viber, LINE, dating apps. Requires Matrix bridgev2 in Go. Blog post
🌐 WebSocket Events Confidence: GET /v1/ws added in v4.2.557 with per-chat subscriptions. No documentation exists for event types, subscription format, or payload schemas. Developers must reverse-engineer.	🔗 Chat SDK Adapters Confidence: chat-adapter-matrix (12 stars) brings Vercel Chat SDK to Beeper. Build bots/integrations using modern AI frameworks that work across ALL bridged networks.

---

Key People

Name	Role	Key Areas	Notable
batuhan	Lead Dev, Desktop API	API, MCP, AgentRemote, Raycast	Primary community contact. Handles bug reports, prompt tweaking, roadmap
tulir	Core Bridge Developer	mautrix bridges, bridge-manager	Creator of mautrix. Maintains 10+ bridges. Matrix ecosystem legend
Kishan Bagaria	Founder & CEO	Product, strategy, bounties	Contact for bridge bounty program ($50K max)
hifi	Bridge Developer	Heisenbridge (IRC), self-hosting	Created Heisenbridge. Active in self-hosting support
blqke	Community	beepctl CLI	Most popular community CLI (30 stars)
KrauseFx	Community	beeper-cli	Felix Krause (Fastlane creator). Read-only chat CLI
lrhodin	Community	iMessage v2 (Rust)	Building Rust iMessage bridge (23 stars). Daily commits
zachatrocity	Community	docker-beeper	Most starred community tool (56 stars). Desktop in Docker
Arjun Ram	Early Adopter	API feedback, token efficiency	Critical early feedback on MCP: chat IDs, token costs, versioning
mimen1994	Community	AI writing style, MCP tools	Pioneered AI chat analysis workflows. Created beeper-mcp

---

Data Sources

Source	Type	Volume	Period
GitHub Ecosystem Audit	Repository metadata	125 official + 35+ community repos	Snapshot: Mar 10, 2026
Documentation Audit	Cross-reference analysis	11 gaps identified	Mar 2026
Dev Community	Matrix room threads	2,161 chunks	Sep 2025 - Mar 2026
Self-hosted Bridges	Matrix room threads	10,911 chunks	Feb 2023 - Mar 2026
Total		13,072 thread chunks, 160+ repos

---

Methodology

This intelligence was gathered through systematic multi-source analysis:

1. GitHub API Audit -- Enumerated all 125 repos in github.com/beeper, plus GitHub search for beeper across all public repos. Captured stars, languages, activity dates, descriptions, and archive status.

2. Documentation Audit -- Crawled all pages on developers.beeper.com. Cross-referenced documented features against community-confirmed features and GitHub code.

3. Community Thread Analysis -- Harvested 2,161 thread chunks from the Dev Community Matrix room (#beeper-developers:beeper.com) spanning Sep 2025 to Mar 2026, and 10,911 chunks from Self-hosted Bridges (#self-hosting:beeper.com) spanning Feb 2023 to Mar 2026.

4. Cross-Reference Synthesis -- Identified repos mentioned in community that don't appear in docs, features confirmed in community with no documentation, and strategic signals from developer communication patterns.

All data is stored in structured JSON in data/ and analyzed in markdown reports in reports/.

---

Repository Structure

beeper-intel/
├── README.md                          # This dashboard
├── LICENSE                            # MIT
├── data/
│   ├── github-ecosystem.json          # All repos: official + community
│   ├── api-changelog.json             # API version history
│   ├── desktop-changelog.json         # Desktop app versions
│   ├── documentation-gaps.json        # 11 identified gaps
│   ├── community-projects.json        # Community tools/bridges/themes
│   ├── key-people.json                # Contributors and roles
│   └── strategic-signals.json         # Major strategic findings
├── reports/
│   ├── agentremote-analysis.md        # AI agent platform deep dive
│   ├── ecosystem-map.md               # Full ecosystem with diagrams
│   ├── documentation-gaps.md          # Feature vs. docs analysis
│   ├── bridge-landscape.md            # Bridge ecosystem catalog
│   └── community-intelligence.md      # Dev community insights
├── timelines/
│   ├── api-evolution.md               # API changelog timeline
│   └── feature-roadmap.md             # Confirmed upcoming features
└── .github/
    └── workflows/
        └── update-data.yml            # Auto-update placeholder

---

Key Links

Resource	URL
Developer Portal	developers.beeper.com
Desktop Changelog	beeper.com/changelog/desktop
GitHub Organization	github.com/beeper
Bridge Bounties	blog.beeper.com/.../build-a-beeper-bridge
Dev Community (Matrix)	#beeper-developers:beeper.com
Self-hosting (Matrix)	#self-hosting:beeper.com
Nightly Downloads	beeper.com/download/nightly/now
npm SDK	@beeper/desktop-api
OpenAPI Spec	github.com/beeper/desktop-api-openapi

---

_{Built with data from 13,072 community messages, 160+ repositories, and hundreds of commits.
Last updated: March 10, 2026}