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.
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.
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.
airegreads 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.agentsso they never drift, and keeps every machine current with a background sync.- Example registries and checks for testing a registry against the specification.
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 installsaireg after asking you, offers the
example registry, and then asks what you want to do next.
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 oraireg.