https://github.com/beeper/agentremote
All your agents in Beeper
https://github.com/beeper/agentremote
Last synced: 2 months ago
JSON representation
All your agents in Beeper
- Host: GitHub
- URL: https://github.com/beeper/agentremote
- Owner: beeper
- License: mit
- Created: 2025-11-17T18:23:53.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-03-30T09:15:16.000Z (2 months ago)
- Last Synced: 2026-03-30T11:25:38.466Z (2 months ago)
- Language: Go
- Homepage:
- Size: 6.88 MB
- Stars: 14
- Watchers: 0
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-beeper - agentremote
README
# AgentRemote
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
Install the latest release:
```bash
curl -fsSL https://raw.githubusercontent.com/beeper/agentremote/main/install.sh | sh
```
Other supported install paths:
- Download a release archive from [GitHub Releases](https://github.com/beeper/agentremote/releases)
- Install via Homebrew: `brew install --cask beeper/tap/agentremote`
The installed CLI stores profile state under `~/.config/agentremote/`.
## Included bridges
| Bridge | What it connects |
| --- | --- |
| `ai` | Talk to any model on Beeper |
| [`codex`](./bridges/codex/README.md) | A local `codex app-server` runtime, requires Codex to be installed |
| [`opencode`](./bridges/opencode/README.md) | A remote OpenCode server or a bridge-managed local OpenCode process |
| [`openclaw`](./bridges/openclaw/README.md) | Connect directly to OpenClaw Gateway, bring all your sessions to one app |
## Quick start
```bash
agentremote login
agentremote list
agentremote run codex
```
Useful commands:
- `agentremote up ` starts a bridge in the background
- `agentremote status` shows local and remote bridge state
- `agentremote logs --follow` tails logs
- `agentremote stop ` stops a running instance
Instance state lives under `~/.config/agentremote/profiles//instances/`.
## Docker
The CLI is also published as a multi-arch Linux container image:
```bash
docker run --rm -it \
-v "$(pwd):/data" \
ghcr.io/beeper/agentremote:latest help
```
The container sets `HOME=/data`, so mounted state is persisted under `/data/.config/agentremote/`. See [`docker/agentremote/README.md`](./docker/agentremote/README.md) for usage details.
## SDK
Custom bridges in this repo are built on [`sdk/`](./sdk), using:
- `bridgesdk.NewStandardConnectorConfig(...)`
- `bridgesdk.NewConnectorBase(...)`
- `sdk.Config`, `sdk.Agent`, `sdk.Conversation`, and `sdk.Turn`
See [`bridges/dummybridge`](./bridges/dummybridge) for a minimal bridge example.
## Docs
- CLI reference: [`docs/bridge-orchestrator.md`](./docs/bridge-orchestrator.md)
- Matrix transport surface: [`docs/matrix-ai-matrix-spec-v1.md`](./docs/matrix-ai-matrix-spec-v1.md)
- Streaming note: [`docs/msc/com.beeper.mscXXXX-streaming.md`](./docs/msc/com.beeper.mscXXXX-streaming.md)
- Command profile: [`docs/msc/com.beeper.mscXXXX-commands.md`](./docs/msc/com.beeper.mscXXXX-commands.md)