ATH is an open protocol and we welcome contributions from the community.

Repository Structure

ATH spans multiple repositories in the ath-protocol organization on GitHub:
RepositoryDescription
agent-trust-handshake-protocolDocumentation site (this repo)
typescript-sdkTypeScript Client SDK
gatewayReference gateway implementation

Ways to Contribute

Report Issues

Found a problem with the specification or documentation? Open an issue on the relevant repository.

Propose Protocol Changes

Have an idea to improve the protocol?
  1. Open a GitHub Discussion to share your use case and proposal
  2. If the community supports the idea, submit a pull request with specification changes
  3. Protocol changes require careful review to maintain backward compatibility

Code Contributions

  • SDK enhancements — New features, better error handling, additional languages → contribute to the SDK repos
  • Gateway improvements — New OAuth bridge modes, performance, storage backends → contribute to the gateway repo
  • Documentation — Clarifications, examples, tutorials → contribute to this repo

Build an SDK

The ATH protocol is language-agnostic. If you’d like to build an SDK for a new language:
  1. Review the API Specification
  2. Implement the agent lifecycle: discover → register → authorize → exchangeToken → proxy
  3. Include proper JWT signing for agent attestation (ES256)
  4. Submit a PR or link to your repository

Contributing to This Site

git clone https://github.com/ath-protocol/agent-trust-handshake-protocol.git
cd agent-trust-handshake-protocol
npm install
npx mintlify dev
The site will be available at http://localhost:3000.

Code of Conduct

Be respectful, constructive, and inclusive. We follow standard open-source community guidelines.

License

ATH is released under the MIT License.