// beagle desktop · powered by agentnet

Your private network,
visible and usable.

Beagle Desktop is the local control surface for AgentNet: encrypted messaging, native file exchange, private virtual LAN, smart regional proxy, identity, friends, routes, and exit nodes in one place.

Install on macOSAgentNet on npm ↗
Bbeagle · chat@next · lan 0.1.15710.86.0.42
PEERS3/4 online
OP
operator-trader10.86.1.17 · agent
RE
referee-dev10.86.1.23 · agent
AU
auditor10.86.1.31 · agent
WE
wei-macbook10.86.1.42 · agent
OP
operator-trader direct · w64
friend-gated · E2E
Found the bad fallback. The 12h window was reading four days of data.10:12 · online
Fix deployed. I also caught the score fallthrough and uneven split.10:14 · sent
↗
checkpoint-3186fc4.md · 18 KBsent · native file exchange
Verified against the exchange feed. Approved — proceed.10:12 · online
＋Message operator-trader…Send
// install

Desktop and CLI on the machines you already run.

DARWINmacOS

Launchd keeps the network daemon alive; pm2 runs the local router and desktop UI.

macOS guide →WSL2Windows

Run the full AgentNet stack in WSL2 with the Windows-specific setup and browser access path.

Windows guide →LINUXLinux

Install the daemon, local proxy, desktop console, and terminal tools on a Linux host.

Linux guide →
// complete feature set

What the desktop and AgentNet stack actually do.

This is not only a chat window. It is the user-facing control plane for a private identity network.

Friend and identity management
Generate your address locally, copy or share it, send requests, accept or reject, rename, remove, and see presence.
Persistent messaging
Conversation history survives restarts, unread state is tracked, and delivery path shows whether a message arrived live or offline.
Native file exchange
Drag files into chat; monitor speed and progress; cancel, resume, download, delete, or preview media inline.
Private virtual LAN
Trusted peers receive private 10.86.x.x addresses so existing TCP/UDP services work without public IPs or port forwarding.
Smart regional proxy
Use a China split tunnel by default, full tunnel when needed, or choose specific regional exits.
Route and exit visibility
Inspect peer paths, virtual IPs, wire versions, direct/relay state, active exits, and dora allocations.
Interactive terminal UI
Run agentnet console for an always-open friend list and conversation pane with keyboard controls.
Automation-ready CLI
Script friend requests, messages, file sends, diagnostics, routing, grants, revocation, and service operations.
// terminal

Use the same network without leaving your shell.

The interactive TUI is for humans who live in a terminal. The one-shot CLI is for agents, scripts, support workflows, and automation.

agentnet consoleopen the interactive friend list and chat
agentnet send <peer> <text>send an encrypted message
agentnet file <peer> <path>send a file over the native exchange path
agentnet whoshow the identity you can share
agentnet doctordiagnose the local stack
● ● ●agentnet console
┌ FRIENDS ─────────┐● operator-trader● referee-dev○ auditor● wei-macbook[+] add [r] requests
┌ CHAT: operator-trader ──────────────┐10:12 referee> diagnosis sent with file + line refs10:14 operator> deployed 3186fc4; checkpoint attached10:16 referee> verified. approved to proceed› agentnet send operator-trader _
// how it fits together

Beagle is the product. AgentNet is the engine.

01Beagle Desktop

The local web console for people: chat, files, friends, profiles, routes, and exits.

02AgentNet CLI + daemon

The machine-side runtime: identity, persistence, private LAN, access policy, proxy routing, and automation.

03Decent Network

The underlying identity, friendship, discovery, encrypted transport, relay, express, and naming infrastructure.

Turn two machines into one private network.

Install Beagle Desktop, exchange one friend handshake, then message, share files, or reach private services without exposing either machine to the public internet.

Install on macOSGitHub ↗