Skip to content

Add Zooid to the ecosystem client list#3470

Open
orivibes wants to merge 4 commits into
matrix-org:mainfrom
orivibes:add-zooid-client
Open

Add Zooid to the ecosystem client list#3470
orivibes wants to merge 4 commits into
matrix-org:mainfrom
orivibes:add-zooid-client

Conversation

@orivibes

@orivibes orivibes commented Jun 15, 2026

Copy link
Copy Markdown

Description

Adds Zooid to the ecosystem client list.

Zooid is an open-source, self-hostable Matrix client for collaborating with AI agents alongside your team. It's built on matrix-js-sdk (Vite + React) and renders the structure of the Agent Client Protocol (ACP) — approval cards, tool calls, sub-agent trees, live plan state — inline in the timeline, next to ordinary human chat, threads, and spaces.

  • Entry: content/ecosystem/clients/zooid.md
  • Logo: content/ecosystem/clients/zooid.svg
  • Feature flags are set honestly: spaces, threads, and SSO supported; E2EE, VoIP, multi-account, and i18n declared unsupported.
  • No webapp package entry — Zooid is self-hosted (shipped with the zooid daemon). A live community instance is linked in the description for trying it without setup.

Source: https://github.com/zooid-ai/clients

Related issues

Closes #3471

Role

Contributing as an individual. I'm affiliated with the Zooid project that this PR adds.

Timeline

No deadline — review whenever convenient.

Signoff

The commit is signed off (DCO check passing).

@orivibes orivibes requested a review from a team as a code owner June 15, 2026 16:49
@github-actions github-actions Bot marked this pull request as draft June 15, 2026 16:50
@github-actions github-actions Bot added the missing-template This PR had the template removed from its description. Please add back and follow the instructions. label Jun 15, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for contributing to the matrix.org website. I have automatically marked your pull request as a draft. Please restore the PR template to your PR description and follow our contributing guidelines, then undraft to let the team know the PR is ready for review.

Zooid is an open-source, self-hostable Matrix client for collaborating
with AI agents alongside your team, built on matrix-js-sdk.

Signed-off-by: Ori Ben <ori@makelinks.co>
@orivibes orivibes marked this pull request as ready for review June 15, 2026 17:00
@github-actions github-actions Bot removed the missing-template This PR had the template removed from its description. Please add back and follow the instructions. label Jun 15, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for applying the PR template. The PR is now ready for review by a human.

@awtj8o81ryywg793 awtj8o81ryywg793 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please have a read of CONTRIBUTING.md, and document the license of the project's logo in a zooid.svg.license file. Thanks!

Comment thread content/ecosystem/clients/zooid.md Outdated
Comment thread content/ecosystem/clients/zooid.md Outdated
Comment thread content/ecosystem/clients/zooid.md Outdated
licence = "MIT"
language = "TypeScript"
latest_release = "2026-06-14"
maturity = "Beta"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not too sure if this should be Alpha or Beta.

@Henry-Hiles

Copy link
Copy Markdown
Contributor

From the website, this seems a little odd, it specifically sites the server as being Tuwunel? I don't know if this is what people would actually want when looking on the clients page for a Matrix client, to me at least it seems too specialized rather than for Matrix as a whole.

@awtj8o81ryywg793 awtj8o81ryywg793 added the ecosystem Adding and removing ecosystem projects label Jun 15, 2026
@orivibes

Copy link
Copy Markdown
Author

From the website, this seems a little odd, it specifically sites the server as being Tuwunel? I don't know if this is what people would actually want when looking on the clients page for a Matrix client, to me at least it seems too specialized rather than for Matrix as a whole.

@Henry-Hiles I'm the maintainer. It works with any matrix server, tuwunel is just what we bundle for people to use locally

@orivibes

orivibes commented Jun 16, 2026

Copy link
Copy Markdown
Author

I updated the website. Here's a clearer explanation of the stack:

  1. ACP (Agent Client Protocol) is the relay from/to the agent
  2. Zooid daemon - is a matrix bridge, mapping ACP events into Matrix using Application Service API
  3. Matrix server (the dev bundle uses tuwunel, but you can use any server you want)
  4. Zooid client - is a matrix client, connects to matrix thru CSAPI, nothing tuwunel-specific

… logo license

Signed-off-by: Ori Ben <ori@makelinks.co>
@orivibes

orivibes commented Jun 17, 2026

Copy link
Copy Markdown
Author

The Zooid client can be used independently of the daemon. Without the daemon - it'll be a graceful degradation to a normal chat app, without ACP features. That's an important feature of the architecture. Also the daemon allows you to talk to an agent without Zooid client (again without ACP features). so the concept here is to build an interoperable chat app + daemon.

@orivibes

Copy link
Copy Markdown
Author

@Henry-Hiles anything else I can do to help advance this PR?

@Henry-Hiles

Copy link
Copy Markdown
Contributor

@Henry-Hiles anything else I can do to help advance this PR?

I'm not part of the Website WG, I cannot really help.

@weeman1337 weeman1337 self-requested a review June 20, 2026 08:54

@weeman1337 weeman1337 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tried out the client to test it's functionality. Unfortunately I wasn't able to get it up and running. I ended up on this page:

image

Can you please update the documentation about setting in up @orivibes ?

@orivibes

Copy link
Copy Markdown
Author

Can you please update the documentation about setting in up

@weeman1337 thanks for the reply!

yes, I added an explanation in https://github.com/zooid-ai/clients
Also added a few features and a friendlier error message so please pull

Anyway, to point it to a homeserver you need to run this way:

VITE_MATRIX_HOMESERVER_URL=https://matrix.example.com pnpm -C packages/web dev

Comment thread LICENSES/LicenseRef-NounProject-RoyaltyFree.txt Outdated
Yeah, that's consistent with the license that I purchased, it says: "This license grants its holder perpetual, non-exclusive, worldwide rights to unlimited use of the licensed image [...] without providing attribution to the Icon creator

Co-authored-by: Jack S. <181536874+awtj8o81ryywg793@users.noreply.github.com>
Signed-off-by: Ori Ben <103140410+orivibes@users.noreply.github.com>
@weeman1337 weeman1337 self-requested a review June 27, 2026 09:36

@weeman1337 weeman1337 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you add

[extra.packages]

The build requires it even if it is empty

The ecosystem/client.html template requires page.extra.packages to
exist; without it Zola fails to render the page. Zooid ships no
downloadable packages, so the table is intentionally empty.

Signed-off-by: Ori Ben <ori@makelinks.co>
@orivibes

Copy link
Copy Markdown
Author

Can you add

[extra.packages]

The build requires it even if it is empty

@weeman1337 done ✅

@orivibes orivibes requested a review from weeman1337 June 28, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ecosystem Adding and removing ecosystem projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Zooid client

4 participants