Cardano Cli Doctor

cardano-cli-doctor

When to use

• Before generating CLI workflows to detect correct command style (era-prefixed vs legacy)
• When debugging CLI flag errors or version mismatches
• When setting up a new environment

Operating rules (must follow)

• Never ask for or log secret key contents
• Prefer read-only diagnostics (--help, version, query tip)
• If air-gapped machine, avoid network commands unless explicitly requested
• Output a Compat Report with recommended command style

Docker fallback mode

If cardano-cli is not installed locally, use the wrapper script in this skill folder to run cardano-cli inside Docker (the Cardano node container images include the CLI).

chmod +x {baseDir}/scripts/cardano-cli.sh
{baseDir}/scripts/cardano-cli.sh version

Notes:

• The wrapper mounts your current directory into the container as /work so files like pparams.json, tx.body, datum.json work normally.
• If you have a local node socket, set CARDANO_NODE_SOCKET_PATH before running so query commands work.
• Override the image with CARDANO_DOCKER_IMAGE=ghcr.io/intersectmbo/cardano-node:.

Workflow

1) Collect environment facts (auto-injected via context)

• CLI version
• Available era-prefixed commands (conway, latest)
• Legacy flag presence (--babbage-era, etc.)

2) Decide command style

• cardano-cli conway --help works → era-prefixed supported
• --babbage-era in help → legacy flags supported
• Both exist → prefer era-prefixed (newer)

3) Network sanity (optional, if socket available)

• cardano-cli query tip --mainnet or --testnet-magic
• Detect: missing socket, wrong magic, sync status

4) Produce Compat Report `` CLI Version: X.Y.Z Era-prefixed: ✓ conway, latest Legacy flags: ✓ --babbage-era Recommended: era-prefixed (cardano-cli conway ...) Network: --testnet-magic 1 (preprod) ``

Examples

Example 1: Modern CLI (era-prefixed)

Input: User has cardano-cli 10.1.0

Output:

=== Cardano CLI Compatibility Report ===

CLI Version: 10.1.0.0
Git Rev: abc123

Supported Commands:
  ✓ cardano-cli conway --help (recommended)
  ✓ cardano-cli latest --help
  ✓ cardano-cli babbage --help

Recommended Style: ERA-PREFIXED
  cardano-cli conway transaction build ...
  cardano-cli conway query utxo ...

Network Flags:
  Mainnet: --mainnet
  Preprod: --testnet-magic 1
  Preview: --testnet-magic 2

Example 2: Legacy CLI

Input: User has cardano-cli 8.x

Output:

=== Cardano CLI Compatibility Report ===

CLI Version: 8.24.0.0

Supported Commands:
  ✗ Era-prefixed not available

Legacy Flags Detected:
  ✓ --babbage-era
  ✓ --alonzo-era

Recommended Style: LEGACY FLAGS
  cardano-cli transaction build --babbage-era ...

Safety / key handling

• Avoid commands that print or touch .skey files
• Recommend chmod 600 *.skey for real funds
• Prefer offline keygen for mainnet

References

• shared/PRINCIPLES.md (repo)
• Cardano CLI documentation

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Flux-Point-Studios
• Source: Flux-Point-Studios/cardano-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.