Skip to main content

Diagrid CLI

The Diagrid CLI (diagridpy) is a command-line tool for managing Diagrid Catalyst resources, deploying agents, and running chaos experiments.

Community

Have questions, hit a bug, or want to share what you're building? Join the Diagrid Community Discord to connect with the team and other users.

Installation

The diagridpy executable ships with the main diagrid package:

pip install diagrid

Installing the standalone diagrid-cli distribution gives you the CLI library code only — it declares no console script, so it installs no diagridpy executable.

Usage

The CLI provides three commands. Run diagridpy --help to see all available commands.

Global flags:

  • -v, --verbose — show subprocess output
  • --env {prod,staging} — target the prod or staging Diagrid API

Commands

Initialization

Initialize a local agent development environment (Catalyst project, Kind cluster, Helm install).

diagridpy init

Deployment

Build and deploy your agent to the Kind cluster.

diagridpy deploy

Chaos

Manage Chaos Mesh experiments for agent resilience testing.

# Start chaos experiments against deployed agents
diagridpy chaos start

# Show active chaos experiments
diagridpy chaos status

# Stop and delete all chaos experiments
diagridpy chaos stop

Configuration

The CLI manages configuration and authentication.

  • Authentication: Supports API key and device code authentication flows for connecting to Diagrid Catalyst.
  • Environment: The global --env {prod,staging} flag selects which Diagrid API the CLI talks to.

Metadata

Release files for diagrid-cli 0.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for diagrid-cli 0.5.3
File Size Uploaded
diagrid_cli-0.5.3.tar.gz 28.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for diagrid-cli 0.5.3
File Interpreter ABI Platform
diagrid_cli-0.5.3-py3-none-any.whl Python 3 none any Details

Total release size: 62.7 kB

Release files / diagrid_cli-0.5.3.tar.gz

Download URL diagrid_cli-0.5.3.tar.gz
Size 28.6 kB
Tags Source
SHA-256 checksum
How to use checksums
dddaaf03cc41aaa8e2f6956b1ebb9301dc0ae17bf7b9c167d40bba46c14a76f0
BLAKE2b-256 checksum
How to use checksums
88d5f9225d00dbb792238280d7c103fb91952c0ed84cb30ab44bb1e5206c64a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Release files / diagrid_cli-0.5.3-py3-none-any.whl

Download URL diagrid_cli-0.5.3-py3-none-any.whl
Size 34.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3031d8ccbf5d7efc61df0f824cb7627cd6e99947026cc5f5cab1265ca7c60e73
BLAKE2b-256 checksum
How to use checksums
a7c5d22e3cda449eb452bf0338d5c9f7eb75c5ee359a4f2a7b1515f7233e37dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.5.3 This release

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page