Skip to main content
You can create markdown files directly in the .kombai/commands/ directory of your project or create or import them via the Rules, Commands & Skills page in Settings. Each command is a .md or .txt file. The file name, without its extension, is the command name you type after /.

​
Run custom commands

  1. Type a slash / in the chat input box to check the available commands.
  2. Select the custom command you want to run.
  3. Add any other instructions you want to add to Kombai.
  4. Press Enter or click the button to run the command.
Kombai will now run the workflow defined in the associated Markdown.

​
Manage commands

Commands can be managed through the Rules, Commands & Skills page in Settings. Kombai supports project-level as well as global commands and lists them under the Individual tab. Project-level commands are specific to a project and are listed under Project Commands, while global commands are supported across all projects and are listed under User Commands. Click Refresh at the top of the page to re-scan the lists from disk.

​
Create a command

  1. Click the icon in the top bar to open the Settings page.
  2. Click the Rules, Commands & Skills tab from the left menu.
  3. Under Commands, click the + Add dropdown and select Create User Command or Create Project Command.
  4. Enter a name for the command and click Create. The name can contain only letters, numbers, dots, and hyphens. Kombai creates a markdown file for it in your home .kombai folder (User Command) or your project’s .kombai folder (Project Command).

​
Import a command

Use this to bring in existing command Markdown files, such as ones generated by Spec Kit or OpenSpec (see the FAQs below).
  1. Click the icon in the top bar to open the Settings page.
  2. Click the Rules, Commands & Skills tab from the left menu.
  3. Under Commands, click the + Add dropdown and select Import User Commands or Import Project Commands.
  4. Browse to and select the .md file or directory of command files you want to import.
Kombai imports .md and .txt files. For a directory, it imports the files directly inside it, not the files in its subfolders. Imported commands stay where they are: Kombai references the files in place rather than copying them. A project command must be inside the current workspace.

​
Delete a command

  1. Click the icon in the top bar to open the Settings page.
  2. Click the Rules, Commands & Skills tab from the left menu.
  3. Under Commands, click the icon next to the command you want to remove, under User Commands or Project Commands, and confirm.
Deleting a command stored in a .kombai/commands folder deletes its file. Deleting an imported command only removes it from Kombai’s list and leaves the file on disk.

​
Team commands

Team commands let you share and discover commands across your team. Publish your local commands for team members to use, or use commands shared by others.
You need to be part of the Team plan to use team commands.

​
Publish a command

You can publish any local command from your repo to your team. To publish a command:
  1. Click the icon in the top bar to open the Settings page.
  2. Click the Rules, Commands & Skills tab from the left menu.
  3. Switch to the Team tab and go to the Team Commands section.
  4. Under Publish Your Commands, select the local commands you want to publish from the dropdown.
  5. Click the Publish button.
The command will now be available to all members of your team.
You must have local commands added in the Commands tab before you can publish them.

​
Discover and use team commands

The Team Commands section (in the Team tab) lists all commands published by members of your team. You can search for commands by name or author using the search bar at the top of the list. To use a team command, type a slash / in the chat input box — team commands appear alongside your local commands in the command list.

​
FAQs

Spec Kit and OpenSpec are tools that allow you to create custom commands. You can import the generated commands folder via the Rules, Commands & Skills page in Settings.For example, if you have a .cursor/commands folder created by OpenSpec, import it as described in “Import a command”.If you are using Spec Kit, you also need to import the specify-rules file, e.g., .cursor/rules/specify-rules.mdc. Kombai imports only .md and .txt files, so copy it to a file with a .md extension first, for example specify-rules.md. Then import that file as described in “Import a rule”.