Command-Line Help for `mirdan`

This document contains the help content for the mirdan command-line program.

Installation

brew install swissarmyhammer/tap/mirdan-cli

Command Overview:

mirdan↴
mirdan agents↴
mirdan new↴
mirdan new skill↴
mirdan new validator↴
mirdan new tool↴
mirdan new plugin↴
mirdan install↴
mirdan uninstall↴
mirdan list↴
mirdan search↴
mirdan info↴
mirdan login↴
mirdan logout↴
mirdan whoami↴
mirdan publish↴
mirdan unpublish↴
mirdan outdated↴
mirdan update↴
mirdan sync↴
mirdan doctor↴
mirdan start↴

`mirdan`

Mirdan manages skills, validators, tools, and plugins across all detected AI coding agents.

Skills are deployed to each agent’s skill directory (e.g. .claude/skills/, .cursor/skills/). Validators are deployed to .avp/validators/ (project) or $XDG_DATA_HOME/avp/validators/ (global, defaults to ~/.local/share/avp/validators/). Tools are deployed to .tools/ and registered in agent MCP configs. Plugins are deployed to agent plugin directories (e.g. .claude/plugins/).

Environment variables: MIRDAN_REGISTRY_URL Override the registry URL (useful for local testing) MIRDAN_TOKEN Provide an auth token without logging in MIRDAN_CREDENTIALS_PATH Override the credentials file location MIRDAN_AGENTS_CONFIG Override the agents configuration file

Usage: mirdan [OPTIONS] <COMMAND>

Subcommands:

agents — Detect and list installed AI coding agents
new — Create a new package from template
install — Install a package (type auto-detected from contents)
uninstall — Remove an installed package
list — List installed packages
search — Search the registry for skills and validators
info — Show detailed information about a package
login — Authenticate with the registry
logout — Log out from the registry and revoke token
whoami — Show current authenticated user
publish — Publish a package to the registry (type auto-detected)
unpublish — Remove a published package version from the registry
outdated — Check for available package updates
update — Update installed packages to latest versions
sync — Reconcile .skills/ with agent directories and verify lockfile
doctor — Diagnose Mirdan setup and configuration
start — Start the Mirdan tray/accessory app

Options:

-d, --debug — Enable debug output to stderr
-y, --yes — Skip confirmation prompts (useful for CI/CD)
--agent <AGENT_ID> — Limit operations to a single agent (e.g. claude-code, cursor)

`mirdan agents`

Detect and list installed AI coding agents

Usage: mirdan agents [OPTIONS]

Options:

--all — Show all known agents, not just detected ones
--json — Output as JSON

`mirdan new`

Create a new package from template

Usage: mirdan new <COMMAND>

Subcommands:

skill — Scaffold a new skill (agentskills.io spec)
validator — Scaffold a new validator (AVP spec)
tool — Scaffold a new tool (MCP server definition)
plugin — Scaffold a new plugin (Claude Code plugin)

`mirdan new skill`

Scaffold a new skill (agentskills.io spec)

Usage: mirdan new skill [OPTIONS] <NAME>

Arguments:

<NAME> — Skill name (kebab-case, 1-64 chars)

Options:

--global — Create in agent global skill directories instead of project-level

`mirdan new validator`

Scaffold a new validator (AVP spec)

Usage: mirdan new validator [OPTIONS] <NAME>

Arguments:

<NAME> — Validator name (kebab-case, 1-64 chars)

Options:

--global — Create in $XDG_DATA_HOME/avp/validators/ instead of .avp/validators/

`mirdan new tool`

Scaffold a new tool (MCP server definition)

Usage: mirdan new tool [OPTIONS] <NAME>

Arguments:

<NAME> — Tool name (kebab-case, 1-64 chars)

Options:

--global — Create in $XDG_DATA_HOME/avp/tools/ instead of current directory

`mirdan new plugin`

Scaffold a new plugin (Claude Code plugin)

Usage: mirdan new plugin [OPTIONS] <NAME>

Arguments:

<NAME> — Plugin name (kebab-case, 1-64 chars)

Options:

--global — Create in global plugin directory

`mirdan install`

Install a package (type auto-detected from contents)

Usage: mirdan install [OPTIONS] <PACKAGE>

Arguments:

<PACKAGE> — Package name, name@version, ./local-path, owner/repo, or git URL

Options:

--global — Install globally
--git — Treat package as a git URL (clone instead of registry lookup)
--skill <SKILL> — Install a specific package by name from a multi-package repo
--mcp — Install as an MCP server instead of a skill/validator
--command <COMMAND> — MCP server command (binary to run). Required when –mcp is set
--args <ARGS> — MCP server arguments

`mirdan uninstall`

Remove an installed package

Usage: mirdan uninstall [OPTIONS] <NAME>

Arguments:

<NAME> — Package name

Options:

--global — Remove from global locations

`mirdan list`

List installed packages

Usage: mirdan list [OPTIONS]

Options:

--skills — Show only skills
--validators — Show only validators
--tools — Show only tools
--plugins — Show only plugins
--json — Output as JSON

`mirdan search`

Search the registry for skills and validators

With a query argument, performs a single search and prints results. Without a query, enters interactive fuzzy search mode.

Usage: mirdan search [OPTIONS] [QUERY]

Arguments:

<QUERY> — Search query (omit for interactive mode)

Options:

--json — Output as JSON

`mirdan info`

Show detailed information about a package

Usage: mirdan info <NAME>

Arguments:

<NAME> — Package name

Authenticate with the registry

Opens a browser for OAuth login. The registry URL can be overridden with MIRDAN_REGISTRY_URL for local testing.

Usage: mirdan login

`mirdan logout`

Log out from the registry and revoke token

Usage: mirdan logout

`mirdan whoami`

Show current authenticated user

Usage: mirdan whoami

`mirdan publish`

Publish a package to the registry (type auto-detected)

Auto-detects package type from directory contents: - SKILL.md present -> publishes as a skill - VALIDATOR.md + rules/ present -> publishes as a validator - TOOL.md present -> publishes as a tool - .claude-plugin/plugin.json present -> publishes as a plugin

Usage: mirdan publish [OPTIONS] [SOURCE]