Skip to main content

Diagrid CLI

The Diagrid CLI allows you to manage and interact with your Diagrid resources. The CLI can perform most actions available in the Diagrid Web Console and provides additional utilities you can use to develop your applications using the APIs. For example, use the Diagrid CLI to:

  • Create and manage apps, agents, MCP servers, components, subscriptions,...
  • Invoke the Diagrid APIs and listen for incoming requests on a given app
  • Connect Diagrid to your local machine to receive pubsub events, service invocations, input bindings, etc. while developing
  • View app logs

Installing the CLI​

Once you have created your Diagrid account, you can access your organization at https://catalyst.diagrid.io.

Next, download and install the Diagrid CLI using the following command:

curl -o- https://downloads.diagrid.io/cli/install.sh | bash

Move the diagrid binary into your path so you can run it from anywhere. For example:

sudo mv ./diagrid /usr/local/bin

Using the CLI​

The CLI is a static binary that should be executed from the command line. Help pages are available for you to navigate the command tree and see what flags are available on each command.

To login to Diagrid:

diagrid login

The Diagrid CLI works with both Diagrid and Dapr Ops Dashboard. If you have access to both, choose which set of commands to use with diagrid product use. The value catalyst selects Diagrid:

diagrid product use catalyst

To verify the current user identity and organization:

diagrid whoami

To clean up your user data, use the logout command:

diagrid logout

Creating your first project​

In order to begin using the Diagrid APIs, you must first create a project. After creating the project, you can begin creating workloads and components.

# Create project with Diagrid infrastructure resources (the managed workflow store is included by default)
diagrid project create myproject --deploy-managed-pubsub --deploy-managed-kv

# Create an appid
diagrid app create my-appid

# Create a subscription to the Diagrid Pub/Sub Broker
diagrid subscription create my-subscription --component pubsub --topic events --route /events --scopes my-appid

# View all resources for the current project and wait until all resources become ready
diagrid project get -a

# Connect a terminal to the App ID and listen for incoming subscription events
diagrid listen --id my-appid --subscription my-subscription

Now in a different terminal:

# Publish a message to the pub/sub broker on the events topic and observe output in the listening terminal
diagrid call publish events --component pubsub --id my-appid --data "hello world"

Other useful commands​

List all projects in an organization:

diagrid project list

Set the default project for all subsequent commands:

diagrid project use my-project

View all resources in a project:

diagrid project get -a
Last updated on