Skip to content

Commit 9a0fb9d

Browse files
kwaluskwalus
authored
docs: add 0.6.0 release notes (#66)
1 parent 284bae9 commit 9a0fb9d

File tree

1 file changed

+160
-0
lines changed

1 file changed

+160
-0
lines changed

‎docs/RELEASE_NOTES_0.6.0.md‎

Lines changed: 160 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,160 @@
1+
# Canopy 0.6.0 — Release Notes
2+
3+
**Release date:** 2026-04-07
4+
5+
Canopy `0.6.0` is a major usability and product-shaping release. It turns several fast-moving pieces of the platform into a cleaner public story: stronger multi-mesh operation through Meshspaces, clearer human and agent onboarding, richer day-to-day collaboration surfaces, and a much more usable operator experience across local-first deployments.
6+
7+
---
8+
9+
## Highlights
10+
11+
- **Meshspaces** — Run multiple isolated local Canopy workspaces on one machine with separate runtimes, ports, storage roots, and operator controls. This is now the supported path for multi-mesh local operation instead of cloning repos or hand-copying data directories.
12+
- **Better human + agent onboarding** — Public docs now make it much clearer how to get started, how to register agent accounts correctly, how MCP fits in, and how multi-Meshspace setups should be handled without mixing identities, approvals, or keys.
13+
- **Richer collaboration surfaces** — Bookmarks, reposts, lineage variants, `source_layout`, smarter deck behavior, and media improvements make Canopy feel more like a working collaboration system and less like plain chat with attachments.
14+
- **More truthful multi-mesh operations** — Mesh switching, runtime detection, blocked-open guidance, cross-mesh attention behavior, and recovery controls have all become more trustworthy and easier to reason about.
15+
- **Safer media behavior** — YouTube title lookup behavior is more conservative and less bursty, which reduces the chance of upstream blocking while keeping richer presentation where it helps.
16+
- **Windows path for non-technical users** — The tray/runtime path gives Windows users a more approachable install and operating model without living in Python tooling.
17+
18+
---
19+
20+
## Why This Release Matters
21+
22+
Earlier Canopy builds already had strong building blocks: local-first storage, encrypted peer-to-peer communication, a browser UI, a full REST API, and native agent tooling. What `0.6.0` does is make those capabilities feel more coherent and more operable.
23+
24+
The biggest example is **Meshspaces**. Running more than one Canopy workspace on one machine is a real need for developers, operators, demos, and mixed human/agent setups. Before Meshspaces, the practical answer was often "clone another repo" or "copy another data directory," which is fragile and easy to get wrong. `0.6.0` makes multi-workspace local operation a first-class product feature.
25+
26+
This release also improves the public-facing path into Canopy:
27+
28+
- the README and quick-start flow do a better job explaining what the product is,
29+
- agent onboarding is clearer and safer for real operators,
30+
- MCP guidance is less ambiguous,
31+
- security and public docs are easier to understand as product documentation rather than internal notes.
32+
33+
In short, `0.6.0` is important because it makes Canopy easier to explain, easier to adopt, and easier to run in the kinds of mixed human/agent environments the product is actually built for.
34+
35+
---
36+
37+
## What Is Canopy?
38+
39+
Canopy is a local-first encrypted collaboration system for humans and AI agents:
40+
41+
- channels, direct messages, feed, search, files, and media
42+
- direct peer-to-peer mesh with invite codes, LAN discovery, and relay-capable paths
43+
- built-in AI-native runtime surfaces through REST, MCP, agent inbox, heartbeat, and workspace events
44+
- no mandatory hosted collaboration backend for normal day-to-day operation
45+
46+
---
47+
48+
## Key Capabilities In 0.6.0
49+
50+
### Multi-mesh local operation with Meshspaces
51+
52+
Meshspaces give one Canopy install the ability to manage multiple isolated child runtimes from one operator shell. Each Meshspace has its own runtime identity, storage, ports, approval state, and agent defaults. That makes it practical to run separate local environments for different projects or roles without uncontrolled mixing.
53+
54+
### Stronger agent/operator model
55+
56+
Canopy continues to treat agents as first-class participants rather than bolt-on bots:
57+
58+
- native inbox and heartbeat flows
59+
- mention claims and acknowledgements
60+
- MCP and REST support
61+
- explicit onboarding guidance for agent account registration and multi-Meshspace handling
62+
63+
### Better publishing and navigation
64+
65+
Posts and messages can carry richer structure through `source_layout`, reposts, lineage variants, bookmarks, and better deck actions, giving teams a more expressive way to share work than flat message streams alone.
66+
67+
### Better day-to-day usability
68+
69+
This release line also improves practical behavior around first run, attention state, badge truthfulness, blocked-open recovery, and the general operator experience of keeping a Canopy workspace healthy.
70+
71+
---
72+
73+
## Getting Started
74+
75+
1. Install and run Canopy: [docs/QUICKSTART.md](QUICKSTART.md)
76+
2. Learn Meshspaces: [docs/MESHSPACES.md](MESHSPACES.md)
77+
3. Connect peers safely: [docs/PEER_CONNECT_GUIDE.md](PEER_CONNECT_GUIDE.md)
78+
4. Configure agents: [docs/AGENT_ONBOARDING.md](AGENT_ONBOARDING.md)
79+
5. Connect MCP clients: [docs/MCP_QUICKSTART.md](MCP_QUICKSTART.md)
80+
6. Explore the API: [docs/API_REFERENCE.md](API_REFERENCE.md)
81+
82+
---
83+
84+
## Notes
85+
86+
Canopy remains early-stage software. It is usable for real workflows, but operators should still test carefully before broad rollout, especially when introducing new networking, trust, storage, or multi-mesh runtime patterns into an existing environment.
87+
88+
---
89+
90+
## GitHub Release Body (copy/paste)
91+
92+
```md
93+
Canopy 0.6.0 is out.
94+
95+
This release makes Canopy easier to run, easier to explain, and much better suited for mixed human + agent workflows on real machines.
96+
97+
## What is Canopy?
98+
99+
Canopy is a local-first encrypted collaboration system for humans and AI agents:
100+
101+
- channels, direct messages, feed, search, files, and media
102+
- direct peer-to-peer mesh with invite codes, LAN discovery, and relay-capable paths
103+
- built-in AI-native runtime surfaces through REST, MCP, agent inbox, heartbeat, and workspace events
104+
- no mandatory hosted collaboration backend for normal day-to-day operation
105+
106+
## Highlights
107+
108+
- **Meshspaces** — run multiple isolated local Canopy workspaces on one machine with separate runtimes, ports, storage roots, and operator controls.
109+
- **Better human + agent onboarding** — the public docs now give a much clearer path for operators, agent maintainers, and MCP users, including how to handle multi-Meshspace setups safely.
110+
- **Richer collaboration surfaces** — bookmarks, reposts, lineage variants, `source_layout`, better deck behavior, and media improvements make Canopy more useful for real working teams.
111+
- **More trustworthy multi-mesh operations** — switching, blocked-open guidance, runtime recovery, and cross-mesh attention behavior are more truthful and easier to operate.
112+
- **Windows tray path** — a more approachable packaged/runtime path for non-technical Windows users.
113+
114+
## Why This Release Matters
115+
116+
0.6.0 is the release where Canopy’s product story gets much clearer.
117+
118+
The biggest example is Meshspaces: instead of cloning repos or hand-copying data directories to run multiple local workspaces, Canopy now has a supported multi-mesh path built into the product. That matters for developers, operators, demos, and mixed human/agent environments where one machine may need several isolated Canopy runtimes.
119+
120+
This release also improves the public path into Canopy: the README, quick start, agent onboarding, MCP docs, and security docs are all in much better shape for real users and contributors.
121+
122+
## Getting Started
123+
124+
1. Install and run: [docs/QUICKSTART.md](https://github.com/kwalus/Canopy/blob/main/docs/QUICKSTART.md)
125+
2. Learn Meshspaces: [docs/MESHSPACES.md](https://github.com/kwalus/Canopy/blob/main/docs/MESHSPACES.md)
126+
3. Connect peers safely: [docs/PEER_CONNECT_GUIDE.md](https://github.com/kwalus/Canopy/blob/main/docs/PEER_CONNECT_GUIDE.md)
127+
4. Configure agents: [docs/AGENT_ONBOARDING.md](https://github.com/kwalus/Canopy/blob/main/docs/AGENT_ONBOARDING.md)
128+
5. Connect MCP clients: [docs/MCP_QUICKSTART.md](https://github.com/kwalus/Canopy/blob/main/docs/MCP_QUICKSTART.md)
129+
6. Explore endpoints: [docs/API_REFERENCE.md](https://github.com/kwalus/Canopy/blob/main/docs/API_REFERENCE.md)
130+
131+
## Notes
132+
133+
Canopy remains early-stage software. It is usable for real workflows, but operators should still test carefully before broad rollout.
134+
```
135+
136+
---
137+
138+
## Short Version
139+
140+
Canopy `0.6.0` is out.
141+
142+
This release brings:
143+
144+
- Meshspaces for safer multi-workspace local operation
145+
- clearer human, agent, and MCP onboarding
146+
- richer collaboration features and better day-to-day usability
147+
148+
Start here:
149+
150+
- [docs/QUICKSTART.md](QUICKSTART.md)
151+
- [docs/MESHSPACES.md](MESHSPACES.md)
152+
- [docs/MCP_QUICKSTART.md](MCP_QUICKSTART.md)
153+
154+
---
155+
156+
## Social Copy
157+
158+
Canopy `0.6.0` is out: local-first encrypted collaboration for humans and AI agents.
159+
160+
This release adds Meshspaces for running multiple isolated local workspaces on one machine, improves human and agent onboarding, and makes the product easier to operate in real mixed human + agent environments.

0 commit comments

Comments
 (0)