# Open-Source Projects And Upstreams

This page documents the repo-level open-source foundations and imported upstream source mirrors that
show up directly in this repository. It is intentionally scoped to major ownership boundaries, not
every transitive package from lockfiles.

## Repository-Level License

- ZoneGaze Matrix repository license: Apache-2.0
- Evidence: [`LICENSE`](../../LICENSE)

## Major Upstream Source Mirrors

| Project | Evidence | Local boundary | Notes |
| --- | --- | --- | --- |
| VS Code OSS | [`plugins/code/upstreams/vscode/LICENSE.txt`](../../plugins/code/upstreams/vscode/LICENSE.txt) | `plugins/code/upstreams/vscode/` | Source mirror for the ZoneGaze Code plugin. Matrix-owned surfaces must keep ZoneGaze branding. |
| Exo | [`plugins/exo/upstreams/exo/LICENSE`](../../plugins/exo/upstreams/exo/LICENSE) | `plugins/exo/upstreams/exo/` | Upstream dashboard/runtime mounted inside Matrix through local adapters. |
| Open Design | [`plugins/open-design/upstreams/open-design/LICENSE`](../../plugins/open-design/upstreams/open-design/LICENSE) | `plugins/open-design/upstreams/open-design/` | Upstream design workspace mounted inside Matrix through local adapters. |
| Joplin snapshot inside Whispr upstreams | [`plugins/whispr/upstreams/joplin/LICENSE`](../../plugins/whispr/upstreams/joplin/LICENSE) | `plugins/whispr/upstreams/joplin/` | AGPL-licensed upstream snapshot kept isolated from Matrix-owned product surfaces. |

## Major Repo-Visible Open-Source Dependencies

These show up directly in workspace manifests and are part of the current implementation story:

- `@cline/sdk` through `packages/cline-sdk/package.json`
- `@modelcontextprotocol/sdk` through the root `package.json`
- `@trpc/client` and `@trpc/server` through the root and web package manifests
- `node-pty` through the root and desktop package manifests
- React, Tailwind CSS, Radix UI, xterm, and `@assistant-ui/react` through `flow/web/package.json`
- Electron through `platforms/desktop/package.json`

Use the package manifests as the authoritative list of where each dependency is used:

- [`package.json`](../../package.json)
- [`flow/web/package.json`](../../flow/web/package.json)
- [`packages/cline-sdk/package.json`](../../packages/cline-sdk/package.json)
- [`platforms/desktop/package.json`](../../platforms/desktop/package.json)

## Service-Boundary Open-Source Infrastructure

- Local Deep Research and SearXNG are used as separate service/container boundaries under
  [`infra/deep-research/`](../../infra/deep-research/README.md)
- Crawl4AI is optional and also kept as a separate container boundary

Those services are intentionally kept outside proprietary Matrix source boundaries.

## Local Boundary Records

- [Plugins package index](../../plugins/README.md)
- [ZoneGaze Code upstream record](../../plugins/code/UPSTREAMS.md)
- [Open Design upstream record](../../plugins/open-design/UPSTREAMS.md)
- [Exo upstream record](../../plugins/exo/UPSTREAMS.md)
- [Joplin upstream boundary](../../plugins/joplin/UPSTREAMS.md)

## Related Notes

- [Tools and integrations](tools-and-integrations.md)
- [Matrix plugin architecture](../architecture/matrix-plugin-architecture.md)
- [AI chat architecture](../architecture/ai-chat.md)
