Open Source

Your agents can't share files. That's insane.

P2P file sync for AI agents. Two prompts, zero config.

Machine A
$
Machine B
$

Three steps. That's it.

No accounts, no dashboards, no YAML files. Just a CLI and a passphrase.

1

Initialize

Run one command on the first machine. botsync starts up and generates a passphrase.

npx botsync init
2

Join

On the second machine, join with the passphrase. Peer discovery happens automatically.

npx botsync join <phrase>
3

Sync

Files in ~/sync/ flow between machines. Real-time, encrypted, P2P. Survives reboots.

~/sync/ ⇄ ~/sync/

Built for agent workflows

The filesystem is the universal interface. botsync makes it work across machines.

🤝

The Handoff

Agent A writes a report. Agent B on another machine picks it up and keeps going. No API, no queue — just files.

Agent Areport.mdAgent B
🐝

The Swarm

Multiple coding agents sharing a project folder across different machines. Collaborative development without Git gymnastics.

Agent 1shared/Agent 2
🌉

The Human Bridge

Agent writes to ~/sync/deliverables/ and it appears on your laptop. Review outputs without SSH or file transfers.

Agentdeliverables/You
🔄

The Multi-Machine Agent

Same agent, persistent state across your laptop, server, and VPS. Context follows wherever the agent runs.

LaptopServerVPS
⛓️

The Tool Chain

Image generation writes to shared/. Website builder picks it up. Deployer ships it. All coordinated through the filesystem.

genbuilddeploy

The sync layer agents deserve

🔒

No Cloud

Direct peer-to-peer. Your files never touch a server. No accounts, no subscriptions.

🛡️

Encrypted

TLS 1.3 in transit. Battle-tested crypto. Your data stays yours.

Zero Config

No YAML. No env vars. No API keys. One command to start, one to join.

♾️

Survives Reboots

Set it up once. Runs as a background service. Files keep flowing after restarts.

🆓

Free & Open Source

MIT licensed. No vendor lock-in. Ever.

Agent-native conventions

botsync gives your agents a shared filesystem with sensible defaults. Drop files in the right folder and they flow to the right place.

  • P2P sync — no central server or cloud storage
  • Conventional ~/sync/ folder structure
  • 4-word passphrases for dead-simple pairing
  • Auto-configures on first run
  • Runs as a background service
  • Works on macOS, Linux, WSL
~/sync/
├── shared/ ← everyone sees everything
├── deliverables/ ← agents write, humans read
├── inbox/ ← humans drop files for agents
└── .botsync ← config (auto-generated)

Ready in 30 seconds

One command. No signup required.

npx botsync init

Requires Node.js 18+