Skip to content

Team Mode

In team mode, your SDM connects to the Atomist service.

You get:

  • triggering, on GraphQL subscriptions. Events are saved up while your SDM is down or restarting.
  • chat integration. The addressChannels function on listener and goal invocations sends messages to linked channels in Slack or MS Teams.
  • queries to a persistent model. Execute GraphQL against the history of your commits, deployments, builds, etc.
  • linkable goal progress logs

What is necessary to enable team mode

You’ll need an Atomist workspace for your team or organization. See Getting started to sign up, or ask your Atomist administrator to invite you to the team’s workspace.

You’ll need the workspace ID and an API key.

Find the workspace ID

On the web interface, you can find the Workspace ID on the settings page (click the gear).

Get an API key

You’ll need an API key that identifies you to the Atomist service. Get one here Obtain this from the web interface, by clicking on your username in the upper right.

Provide the API key to the SDM

Supply the API in configuration – the easiest way is by running atomist config in your terminal, or by populating the API key in your $HOME/.atomist/client.config.json file.

See your SDM registration

When your SDM registers with the Atomist service, you can see this registration in the Atomist web interface.

Go to, log in, and make sure your team is selected. Then click on the little “Settings” gear.

Settings button in the web interface]

Choose “Automation Clients” from the tab. (This includes SDMs.) This will show you a list of registered SDMs and built-in automations. Click the little down arrow to expand information.

Client list in the web interface]

The detailed information on the registered SDM includes commands, event subscriptions, and a metadata section. The metadata section has clues about where it’s running, such as the system.hostname. It also shows the atomist.policy: durable or ephemeral.

Durable subscriptions

An SDM that starts up as durable (usually because you ran it with ATOMIST_ENV=production) will get all the events it subscribes to, even if it is not up all the time. The Atomist service saves events for it (up to a point). This registration will remain active even when the SDM is down. Every unique name/version combination will remain active until you delete the registration in the web interface.

Click “delete” to remove a durable registration. You’ll need to do this when you upgrade your SDM to a new version, after you shut down the old version.

Delete registration button]

In development mode, like when you’re experimenting with an SDM on your laptop, you want atomist.policy to be ephemeral. Events are sent while the SDM is up, and ignored while it is down. The registration disappears when the SDM disconnects.

More info