Commands#

Sidekick provides built-in commands and dynamically registers commands from imported OpenAPI specs.

Built-in commands#

CommandDescription
sdkck commandsList all sdkck commands.
sdkck help [COMMAND]Display help for sdkck.
sdkck search QUERYSearch for available commands
sdkck versionShow version info

API commands#

CommandDescription
sdkck api import SOURCEImport an OpenAPI spec, Postman collection, or GraphQL schema
sdkck api list [NAME]List imported API specs and their available operations
sdkck api call NAME OPERATIONIDCall an imported API operation
sdkck api auth add APIAdd an auth profile for an imported API
sdkck api auth update APIUpdate an auth profile for an imported API
sdkck api auth delete APIDelete an auth profile for an imported API
sdkck api auth list APIList auth profiles for an imported API
sdkck api auth profile APIGet or set the default auth profile for an imported API
sdkck api config NAMEUpdate configuration for an imported API spec
sdkck api remove NAMERemove an imported API spec

Permission commands#

CommandDescription
sdkck permission allow PATTERNAllow a command pattern in the permission list
sdkck permission check COMMANDCheck whether a command is allowed and which rule decides it
sdkck permission disallow PATTERNDisallow a command pattern in the permission list
sdkck permission export FILEExport the permission configuration to a JSON file
sdkck permission import FILEImport the permission configuration from a JSON file
sdkck permission listList all rules in the permission list
sdkck permission remove PATTERNRemove a rule from the permission list
sdkck permission resetReset all permission rules

Plugin commands#

CommandDescription
sdkck pluginsList installed plugins.
sdkck plugins add PLUGINInstalls a plugin into sdkck.
sdkck plugins:inspect PLUGIN...Displays installation properties of a plugin.
sdkck plugins install PLUGINInstalls a plugin into sdkck.
sdkck plugins link PATHLinks a plugin into the CLI for development.
sdkck plugins remove [PLUGIN]Removes a plugin from the CLI.
sdkck plugins resetRemove all user-installed and linked plugins.
sdkck plugins uninstall [PLUGIN]Removes a plugin from the CLI.
sdkck plugins unlink [PLUGIN]Removes a plugin from the CLI.
sdkck plugins updateUpdate installed plugins.

Synonyms commands#

The search command matches command synonyms; export and import them as JSON:

CommandDescription
sdkck synonyms export [FILE]Export the stored synonyms to a JSON file or stdout
sdkck synonyms import FILEImport synonyms from a JSON file

MCP commands#

CommandDescription
sdkck mcp startStart the MCP server (stdio or Streamable HTTP transport)
sdkck mcp token generateCreate a Bearer token enforced by the HTTP transport
sdkck mcp token showDisplay the current MCP HTTP token
sdkck mcp token deleteRemove the MCP HTTP token (disabling auth)
sdkck mcp client addRegister an external MCP server's tools as CLI commands

The MCP commands come from the JIT plugins @hesed/mcp-server and @hesed/mcp-client, which auto-install on first use — that is why they do not appear in sdkck commands output before installation. See MCP Server and MCP Client.

Dynamic commands#

When you import an OpenAPI spec, every operation becomes a command under the spec name:

# After importing a spec named "petstore"
sdkck petstore listPets
sdkck petstore getPetById --param petId=42
sdkck petstore createPet --body name=Fido

These dynamic commands appear in sdkck help and sdkck commands just like built-in commands.

Getting help#

sdkck --help              # General help
sdkck api --help          # Topic help
sdkck api import --help   # Command-specific help