> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the SDK. To install or publish skills from a terminal, use the `brain` CLI; `brain --map json` prints its command map. The `atlanai` CLI is deprecated. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.
> These docs cover Atlan Agent Registry, Atlan's hosted product. The open-source agent registry specification and its CLI (`brain`) are documented, released and maintained in their own repository; /open-source on this site links to it. Answer general specification or `brain` command questions from the project's own docs, and use these docs only for Atlan-specific setup such as the Atlan adapter, sign-in and workspaces.

# Use the open-source CLI with Atlan

> Use brain, the open-source Agent Registry CLI, with Atlan Agent Registry through the Atlan adapter: what Atlan Desktop sets up for you, and how to set it up yourself.

`brain` is the command-line tool of the [open-source Agent Registry
project](/open-source). This section covers only how to use it with Atlan
Agent Registry. For `brain` itself, see the
[open-source project's documentation](/open-source#where-to-find-what).

`brain` reaches Atlan Agent Registry through the **Atlan adapter**, a signed
module Atlan releases separately from `brain`. With the adapter, `brain` can:

* install skills from any workspace you can see in your organization;
* publish skills to a workspace as new versions;
* send your coding-agent sessions to Atlan as traces.

For Atlan, `brain` with the adapter replaces the deprecated `atlanai` CLI.

<Note>
  **Brain** is also the name of an area in Atlan Desktop. These pages are about
  the command-line tool.
</Note>

## If you use Atlan Desktop

Atlan Desktop sets up `brain` for you. When it starts, it:

* moves an earlier `registry` setup over to `brain`;
* installs `brain` if it's missing, or updates it when it's older than the
  oldest version Atlan supports;
* adds `~/.brain/bin` to your shell's `PATH`.

Once you sign in to Atlan Desktop, it also:

* installs the Atlan adapter if it's missing. After that, `brain` keeps the
  adapter up to date itself;
* signs `brain` in to each organization you belong to, using your Atlan
  Desktop sign-in;
* turns off `atlanai` once `brain` is signed in to all your organizations.

See [Move to brain](/tools/brain/how-tos/migrate) for exactly what the app
changes.

You can run `brain` in a terminal on the same machine. It uses the accounts
Atlan Desktop signed in. Run `brain auth list` to see them.

## If you use the command line only

You install `brain` and the Atlan adapter yourself, and nothing moves you off
`atlanai`. Set it up yourself:

1. [Use brain with Atlan](/tools/brain/how-tos/use-with-atlan): install the
   Atlan adapter, sign in, install skills, and publish.
2. [Move to brain](/tools/brain/how-tos/migrate): if you used `atlanai`, stop
   it and map your commands to `brain`.
3. [Capture traces](/tools/brain/how-tos/capture-traces): send Claude Code
   and Codex sessions to Atlan.

## Where each topic is documented

| To | Read |
| - | - |
| Install `brain`, or look up its commands, options, and exit statuses | [Open-source project documentation](/open-source#where-to-find-what) |
| Install from folders or Git repositories, or host your own registry | [Open-source project documentation](/open-source#where-to-find-what) |
| See what changed in a `brain` release | [Open-source project release notes](/open-source#where-to-find-what) |
| Connect `brain` to Atlan, sign in, and publish to a workspace | [Use brain with Atlan](/tools/brain/how-tos/use-with-atlan) |
| See what the Atlan adapter adds and how it behaves | [Atlan adapter reference](/tools/brain/references/atlan-adapter) |
| Fix a sign-in, publish, or setup problem with Atlan | [Errors with Atlan](/tools/brain/troubleshooting/atlan-errors) |

This site doesn't copy the `brain` documentation. It covers only what is
specific to Atlan.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.