Skip to content

Commands

Commands are single-file assets that define custom slash commands available to coding agents during a session.

Directory layout

commands/
├── deploy-all.md
└── review-pr.md

File format

Each command is a markdown file whose base filename becomes the slash command name. For example, deploy-all.md registers as /deploy-all. The file contains the instructions the agent follows when the command is invoked. Frontmatter is optional.

Deploy behavior

nd symlinks the individual file into the target location. Running nd deploy commands/deploy-all produces:

~/.claude/commands/deploy-all.md → <source>/commands/deploy-all.md

Scope rules

ScopeTarget path
Global~/.claude/commands/<name>.md
Project.claude/commands/<name>.md

Related

Create a command

cat > ~/my-assets/commands/deploy-all.md << 'EOF'
Deploy all available assets from all sources using nd deploy.
List assets first with nd list, then deploy each one.
EOF
nd deploy commands/deploy-all