Codebolt is a comprehensive CLI tool created using Node.js. It allows developers to create, manage, and publish AI agents and MCP (Model Context Protocol) tools, along with various utility functions for development.
To install Codebolt CLI tool globally, ensure you have Node.js and npm installed, then run:
npm install -g codebolt-cliBefore using most features, you'll need to authenticate:
codebolt-cli loginTo logout:
codebolt-cli logoutCheck the application version:
codebolt-cli versionCreate a new Codebolt Agent:
codebolt-cli createagent
codebolt-cli createagent -n "MyAgent" --quickPublish an agent to the registry:
codebolt-cli publishagent [folderPath]List all agents created and uploaded by you:
codebolt-cli listagentsStart an agent in the specified working directory:
codebolt-cli startagent [workingDir]Pull the latest agent configuration from server:
codebolt-cli pullagent [workingDir]Clone an agent using its unique_id:
codebolt-cli cloneagent <unique_id> [targetDir]Create a new MCP (Model Context Protocol) tool:
codebolt-cli createtool
codebolt-cli createtool -n "MyTool" -i "my-tool-id" -d "Tool description"Options:
-n, --name <name>: Name of the tool-i, --id <unique-id>: Unique identifier (no spaces)-d, --description <description>: Description of the tool-p, --parameters <json>: Tool parameters in JSON format
Publish an MCP tool to the registry:
codebolt-cli publishtool [folderPath]This command will:
- Read the
codebolttool.yamlconfiguration file - Package and upload the tool's source code
- Register the tool in the MCP registry
- Handle both new tool creation and updates
Requirements for publishing:
- A
codebolttool.yamlfile must be present in the tool directory - Required fields in
codebolttool.yaml:name,uniqueName,description
Interactive prompts for new tools:
- GitHub repository URL (optional)
- Category selection
- Tags (comma-separated)
- API key requirement
List all MCP tools published by you:
codebolt-cli listtoolsPull the latest MCP tool configuration from server:
codebolt-cli pulltools [workingDir]This command will:
- Read your local
codebolttool.yamlfile - Fetch the latest configuration from the server
- Compare versions and prompt for confirmation if needed
- Update your local configuration file
Run a specified tool with a file:
codebolt-cli runtool <command> <file>Inspect a server file using the MCP inspector:
codebolt-cli inspecttool <file>When creating or publishing MCP tools, ensure your codebolttool.yaml file contains:
name: "My MCP Tool"
uniqueName: "my-mcp-tool"
description: "Description of what this tool does"
version: "1.0.0"
parameters:
param1: "value1"
param2: "value2"Agents should contain a codeboltagent.yaml configuration file.
MCP tools should contain a codebolttool.yaml configuration file and follow the MCP protocol standards.
cd my-mcp-tool-directory
codebolt-cli publishtoolcd my-existing-tool
codebolt-cli publishtoolThe CLI will automatically detect if it's an update based on the uniqueName in your configuration.
The CLI provides detailed error messages and colored output for better user experience. Make sure you're authenticated and have the required configuration files before running publish commands.
Codebolt Team
ISC