AgentRemote securely brings agents to Beeper. You can connect agents like OpenClaw, OpenCode, Codex and more to Beeper with streaming, native interfaces for tool calls and approvals. You can run coding agents on your laptop and use your iPhone to manage them.
AgentRemote can run on the same device as your agent and can work behind a firewall. It connects to Beeper Cloud directly and creates an E2EE tunnel.
**This repository is still experimental. Expect everything to be broken for now. **
Install the latest release:
curl -fsSL https://raw.githubusercontent.com/beeper/agentremote/main/install.sh | shOther supported install paths:
- Download a release archive from GitHub Releases
- Install via Homebrew:
brew install --cask beeper/tap/agentremote
The installed CLI stores profile state under ~/.config/agentremote/.
| Bridge | What it connects |
|---|---|
ai |
Talk to any model on Beeper |
codex |
A local codex app-server runtime, requires Codex to be installed |
opencode |
A remote OpenCode server or a bridge-managed local OpenCode process |
openclaw |
Connect directly to OpenClaw Gateway, bring all your sessions to one app |
agentremote login
agentremote list
agentremote run codexUseful commands:
agentremote up <bridge>starts a bridge in the backgroundagentremote statusshows local and remote bridge stateagentremote logs <instance> --followtails logsagentremote stop <instance>stops a running instance
Instance state lives under ~/.config/agentremote/profiles/<profile>/instances/.
The CLI is also published as a multi-arch Linux container image:
docker run --rm -it \
-v "$(pwd):/data" \
ghcr.io/beeper/agentremote:latest helpThe container sets HOME=/data, so mounted state is persisted under /data/.config/agentremote/. See docker/agentremote/README.md for usage details.
Custom bridges in this repo are built on sdk/, using:
bridgesdk.NewStandardConnectorConfig(...)bridgesdk.NewConnectorBase(...)sdk.Config,sdk.Agent,sdk.Conversation, andsdk.Turn
See bridges/dummybridge for a minimal bridge example.
- CLI reference:
docs/bridge-orchestrator.md - Matrix transport surface:
docs/matrix-ai-matrix-spec-v1.md - Streaming note:
docs/msc/com.beeper.mscXXXX-streaming.md - Command profile:
docs/msc/com.beeper.mscXXXX-commands.md