aerosync 0.1.0

Fast, agent-friendly file transfer with auto protocol negotiation (HTTP/QUIC), resumable chunked uploads, and CLI. Library + binary.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

# Installing AeroSync

There are five supported channels. Pick whichever fits your environment.

## 1. One-line installer (macOS / Linux, x86_64 + arm64)

```bash
curl -fsSL https://raw.githubusercontent.com/TechVerseOdyssey/AeroSync/master/install.sh | bash
```

What it does:

1. Detects your OS and CPU.
2. Resolves the latest GitHub Release tag.
3. Downloads the matching archive **and** its `.sha256`, then verifies.
4. Installs `aerosync` and `aerosync-mcp` into `$HOME/.local/bin`
   (no sudo) or, if that's not writable, `/usr/local/bin` with `sudo`.

Pin a specific version or change the prefix:

```bash
AEROSYNC_VERSION=v0.2.0 AEROSYNC_PREFIX=/opt/aerosync/bin bash install.sh
```

## 2. Homebrew (macOS / Linux)

> Requires the tap repo `TechVerseOdyssey/homebrew-aerosync` to be
> published. See [`homebrew.rb`](install/homebrew.rb) for the formula
> template that is copied there on each release.

```bash
brew tap TechVerseOdyssey/aerosync
brew install aerosync
```

## 3. Cargo (any platform with Rust ≥ 1.89)

```bash
cargo install --locked aerosync          # CLI only
cargo install --locked aerosync-mcp      # MCP server
```

Builds from source — no prebuilt binary, no checksum verification, but
it works on any architecture supported by Rust.

## 4. Prebuilt archives (manual)

Grab a tarball/zip from
[GitHub Releases](https://github.com/TechVerseOdyssey/AeroSync/releases),
verify the `.sha256`, extract, and place `aerosync` / `aerosync-mcp` on
your `$PATH`.

```bash
curl -LO https://github.com/TechVerseOdyssey/AeroSync/releases/download/v0.1.0/aerosync-0.1.0-aarch64-apple-darwin.tar.gz
curl -LO https://github.com/TechVerseOdyssey/AeroSync/releases/download/v0.1.0/aerosync-0.1.0-aarch64-apple-darwin.tar.gz.sha256
shasum -a 256 -c aerosync-0.1.0-aarch64-apple-darwin.tar.gz.sha256
tar -xzf aerosync-0.1.0-aarch64-apple-darwin.tar.gz
sudo mv aerosync-0.1.0-aarch64-apple-darwin/aerosync* /usr/local/bin/
```

## 5. From source

```bash
git clone https://github.com/TechVerseOdyssey/AeroSync.git
cd AeroSync
cargo build --release
# binaries: target/release/aerosync, target/release/aerosync-mcp
```

## Verifying the install

```bash
aerosync --version
aerosync-mcp --help    # prints the MCP usage banner
```

## Uninstalling

```bash
rm "$(command -v aerosync)" "$(command -v aerosync-mcp)"
rm -rf ~/.aerosync     # removes config and resume state
```

## Notes for AI agent integrations

After installing, register `aerosync-mcp` with your MCP-compatible
client. The minimum config (Claude Desktop / Claude Code / Cursor) is:

```jsonc
{
  "mcpServers": {
    "aerosync": {
      "command": "aerosync-mcp",
      "env": { "AEROSYNC_MCP_SECRET": "change-me" }
    }
  }
}
```

See [`mcp-integration.md`](mcp-integration.md) for the full tool list,
schemas and runtime environment variables.