Command reference

cardano-init [OPTIONS]            # create a project (interactive, or one-shot with --name)
cardano-init list [--table]       # list roles and tools
cardano-init doctor               # check this project's dependencies
cardano-init add [ROLE FLAGS]     # add or replace a tool in the current project
cardano-init remove [ROLE FLAGS]  # remove a role or infrastructure provider
cardano-init help [COMMAND]       # print help

Every command accepts the global --format <human|json> flag (default human). See For coding agents for the JSON output.

Create a project

cardano-init                                       # interactive mode
cardano-init --name my-app --on-chain aiken        # one-shot, single role
cardano-init --name my-app --on-chain aiken --off-chain meshjs --nix
cardano-init -n my-app -p scalus -d yaci           # short flags

With --name, the command runs in one-shot mode and never prompts. Without it, the command starts the interactive setup. Any other creation flag without --name is an error (name_required).

Short flags and aliases behave exactly like the long flag. Errors and JSON output always use the long name. If the project directory already exists and is not empty, the command stops with dir_exists.

list

List the available roles and tools, including each tool’s language, status, documentation, supporting tooling, and community links.

cardano-init list                 # detailed, grouped by role
cardano-init list --table         # compact matrix of tools by role
cardano-init list --format json   # machine-readable catalog

doctor

Run doctor inside a generated project. It finds the project’s components, checks that the toolchains they need are installed, and prints the install command for each one that is missing. It also lists the supporting tools (editor extensions, language servers) and the community channels for those components.

cd my-protocol
cardano-init doctor
cardano-init doctor --format json

add

Add a tool to the project in the current directory, or replace the tool of a role. add takes the same role flags as project creation.

cardano-init add --on-chain plinth            # replace the on-chain tool
cardano-init add --devnet yaci                # add a devnet
cardano-init add --infra kupo --infra ogmios  # add infrastructure providers
cardano-init add --fullstack scalus           # switch to a fullstack protocol/ component

Plus the shared update flags.

remove

Remove a role, or one infrastructure provider, from the project in the current directory. Role flags take no value, except --infra, which takes the provider id.

cardano-init remove --devnet
cardano-init remove --infra ogmios
cardano-init remove --off-chain --formal-methods

Plus the shared update flags.

Shared update flags

add and remove read the project’s current tools from its component directories, apply the change, and update the shared top-level files (Justfile, README.md, AGENTS.md, …). By default they need a clean git working tree, so you can review the change with git diff and revert it.

Exit codes

For the exact error, use --format json and read error.code. See Error codes.