Skip to content

knosh list-commands

List all file-defined commands found in the commands directory.

Synopsis

knosh list-commands

Description

list-commands scans the commands directory and prints each command's name, agent ID, and description. It is useful for verifying that your command files loaded correctly and for discovering commands that others have added.

See File-Defined Commands for how to author command files.

Output

The output includes the path to the commands directory, followed by an entry for each command:

Commands directory: /Users/alice/.config/knosh/commands

## review-pr
- agent: code-reviewer
- description: Review the staged diff and suggest improvements

## summarise
- agent: writing-assistant
- description: Summarise the current document

Commands without a description field in their frontmatter omit the description line.

Tip

If the commands directory is empty or does not exist, list-commands prints No commands found. Run knosh init --global to create the directory.