Skip to main content
Registry OSS is Atlan’s open-source agent registry: a specification that makes agent registries an open standard, and aireg, a CLI that works with any registry that follows it. Atlan created both and develops them in the open under the Apache 2.0 license.

Registry OSS on GitHub

Read the specification, try the quickstart, report an issue, or contribute.
Anyone can use Registry OSS on their own storage. Atlan Trident is Atlan’s hosted product, which this site documents. Registry OSS is open source; Atlan Trident is not.

Why an agent registry

Skills and agent definitions hold your team’s know-how: how you review code, which data to trust, how you ship. They change often, so every person ends up with their own copy, every coding agent on their machine has a different version, and nobody can tell which copy is current or retire the ones that aren’t. An agent registry stores your organization’s skills and agents and manages their lifecycle. With one, you:
  • keep every skill and agent in one place, with every version;
  • install the same verified version into every coding agent, on every machine;
  • roll out a new version and have everyone’s coding agents pick it up;
  • roll back or retire a version for everyone at once.
A shared Git repository of skills isn’t enough on its own: each person gets whatever copy is there when they install, so teammates end up running different copies and nobody can tell which. A registry can live in a Git repository too, but it pins and verifies every version, gives every machine identical files, and keeps all your coding agents in sync from one record.

What the open standard adds

Registries are often tied to one ecosystem or one vendor’s storage, so only that vendor’s tools can read your artifacts, and moving them means a migration. Registry OSS standardizes the registry instead of the server:
  • Open format. A client integrates with the specification once, reads any registry that follows it, and installs into any coding agent.
  • Open storage. A registry is a set of files in a defined layout, so it can live on infrastructure you already have, such as a Git repository or an object storage bucket. aireg reads registries in folders and Git repositories today.

What is open source

The open-source repository contains:
  • The registry file specification, with its JSON schemas: a discovery document, an index, and an immutable record per artifact version with a digest for every file, so clients can verify exactly what they install.
  • aireg, the CLI for the specification. It creates registries and publishes versions to them, finds the skills your coding agents already have, installs artifacts with exact versions pinned in a lockfile, links one copy into Claude Code, Codex, Cursor, and .agents so they never drift, and keeps every machine current with a background sync.
  • Example registries and checks for testing a registry against the specification.
Today the specification covers skills and agents. The specification is a draft and aireg has not reached 1.0, so both may still change.

Try it with your coding agent

Paste this into Claude Code, Codex, or Cursor. The repository includes a setup skill your agent follows: it installs aireg after asking you, offers the example registry, and then asks what you want to do next.
To install aireg yourself, follow the quickstart.

How Atlan Trident relates

Atlan Trident is Atlan’s hosted product, with a managed registry. It adds what an organization needs to run one: workspace permissions, roles and SSO, approvals and security scans before a version is served, search, and traces and evals that show how each skill and agent is used. aireg works with Atlan Trident through the Atlan adapter, a signed module Atlan releases separately from the CLI. So you can start with a registry in a Git repository and add Atlan Trident when you need governance, with the same CLI and the same skills. See CLI with Atlan.

Where to find what

Review an installer before you run it, and follow your organization’s process for installing software.

Other open source from Atlan

Registry OSS is one of several projects Atlan publishes. Atlan engineers also contribute to the open-source projects Atlan runs on, such as DuckDB and OpenLineage. Open source at Atlan lists all of them, with Atlan’s talks and engineering writing. The projects below come up when you work with Atlan Trident. None of them is part of Registry OSS.

Releases and changes

The open-source project announces its releases in its release notes on GitHub. The Atlan changelog covers Atlan Trident, the hosted product, so it does not list releases of the specification or aireg.