codemie-plugins 0.1.119

Command-line interface for running CodeMie Plugins toolkits

EPAM AI/Run CodeMie Plugins CLI

A command-line interface for running AI/Run CodeMie Plugins toolkits.

Table of Contents

• Overview
• Installation
  • Using pip
  • From Source
• Configuration
  • Setting Up Your Plugin Key
  • Configuration File
  • Environment Variables
• Commands
  • Global Options
  • List Command
  • Config Command
  • MCP Command
  • Development Command
• Code Command
• Custom MCP Servers
• Graceful Shutdown
• Troubleshooting
• Contributing
• License

Overview

The CodeMie Plugins CLI provides a convenient way to interact with CodeMie toolkits and MCP (Model Context Protocol) servers. It offers a unified interface for:

• Running development toolkits on repositories
• Managing and running MCP servers
• Configuring plugin settings
• Listing available commands and toolkits

This CLI is designed to be cross-platform and easy to use, with a focus on developer experience.

Installation

Using uvx (Recommended)

Recommended option to install cli is to use uvx(For installation instructions for uvx, see the uv documentation):

# Install
uvx pip install codemie-plugins

# Run
uvx codemie-plugins

Using pip

Pip installation:

pip install codemie-plugins

From Source

To install from source:

# Clone the repository
git clone https://gitbud.epam.com/epm-cdme/codemie-plugins.git
cd codemie-plugins

# Install using pip
pip install -e .

# Or using poetry
poetry install

Configuration

Setting Up Your Plugin Key

Before using the CLI, you need to set up your plugin key:

1. Generate a plugin key using the built-in command:

   codemie-plugins config generate-key
   

   This will generate a random UUID and set it as your plugin key.

2. Alternatively, set a specific plugin key in your configuration:

   codemie-plugins config set PLUGIN_KEY your-plugin-key
   

3. Or set it as an environment variable:

   export PLUGIN_KEY=your-plugin-key
   

Configuration File

The CLI uses a configuration file located at $HOME/.codemie/config.json. You can manage this configuration using the config command:

# View current configuration
codemie-plugins config list

# Set a configuration value
codemie-plugins config set KEY VALUE

# Get a specific configuration value
codemie-plugins config get KEY

Environment Variables

The following environment variables can be used to configure the CLI:

• PLUGIN_KEY: Authentication key for the plugin engine
• PLUGIN_ENGINE_URI: URI for the plugin engine (typically a NATS server)
• COMMAND_LINE_TOOL_TIMEOUT: Timeout for command line tools (in seconds)

Commands

Global Options

The following options are available for all commands:

--plugin-key TEXT          Authentication key for the plugin engine
--plugin-engine-uri TEXT   URI for the plugin engine (typically a NATS server)
--debug / --no-debug       Enable debug mode
--version                  Show the version and exit
--help                     Show help message and exit

List Command

The list command displays available CLI commands:

codemie-plugins list [OPTIONS]

Options:

• --verbose, -v: Display detailed information about each command

Example:

# List available commands
codemie-plugins list
# or with uvx
uvx codemie-plugins list

# List commands with detailed information
codemie-plugins list -v
# or with uvx
uvx codemie-plugins list -v

Config Command

The config command manages CLI configuration settings:

codemie-plugins config SUBCOMMAND [OPTIONS]

Subcommands:

• list: List current configuration settings
  • --all: Show all configuration including environment variables
• set KEY VALUE: Set a configuration value
• get KEY: Get a specific configuration value
• generate-key: Generate a random UUID and set it as the plugin key

Examples:

# List current configuration
codemie-plugins config list
# or with uvx
uvx codemie-plugins config list

# Show all configuration
codemie-plugins config list --all
# or with uvx
uvx codemie-plugins config list --all

# Set a configuration value
codemie-plugins config set PLUGIN_KEY your-plugin-key
# or with uvx
uvx codemie-plugins config set PLUGIN_KEY your-plugin-key

# Get a specific configuration value
codemie-plugins config get PLUGIN_KEY
# or with uvx
uvx codemie-plugins config get PLUGIN_KEY

# Generate a random UUID and set it as the plugin key
codemie-plugins config generate-key
# or with uvx
uvx codemie-plugins config generate-key

MCP Command

The mcp command manages Model Context Protocol servers and connections:

codemie-plugins mcp SUBCOMMAND [OPTIONS]

Subcommands:

• list: List available MCP servers
• run: Run MCP with specified servers
  • --servers, -s TEXT: Comma-separated list of server names to run (required)
  • --env, -e TEXT: Server-specific environment variables (format: 'server_name=VAR1,VAR2')
  • --timeout, -t INTEGER: Timeout in seconds

Examples:

# List available MCP servers
codemie-plugins mcp list
# or with uvx
uvx codemie-plugins mcp list

# Run a single server
codemie-plugins mcp run -s filesystem
# or with uvx
uvx codemie-plugins mcp run -s filesystem

# Run multiple servers
codemie-plugins mcp run -s filesystem,cli-mcp-server -e cli-mcp-server=ALLOWED_DIR
# or with uvx
uvx codemie-plugins mcp run -s filesystem,cli-mcp-server -e cli-mcp-server=ALLOWED_DIR

# Run with environment variables
codemie-plugins mcp run -s filesystem -e filesystem=FILE_PATHS
# or with uvx
uvx codemie-plugins mcp run -s filesystem -e filesystem=FILE_PATHS

Development Command

The development command provides development toolkit commands for working with repositories:

codemie-plugins development SUBCOMMAND [OPTIONS]

Subcommands:

• run: Run development toolkit on a repository
  • --repo-path PATH: Path to the repository directory
  • --timeout, -t INTEGER: Timeout in seconds for command execution

Examples:

# Run development toolkit on current directory
codemie-plugins development run
# or with uvx
uvx codemie-plugins development run

# Run development toolkit on a specific repository
codemie-plugins development run --repo-path /path/to/repo
# or with uvx
uvx codemie-plugins development run --repo-path /path/to/repo

# Run with a custom timeout
codemie-plugins development run --timeout 600
# or with uvx
uvx codemie-plugins development run --timeout 600

Code Command

The code command launches an interactive AI-powered coding assistant that helps with various programming tasks:

codemie-plugins code [OPTIONS]

Options:

• --model, -m TEXT: The model to use for the coding assistant (default: gpt-4o)
• --temperature, -t FLOAT: Temperature setting for the model (0.0-1.0) (default: 0.7)
• --allowed-dir, -d TEXT: Directories the agent is allowed to access (can specify multiple)
• --verbose, -v: Verbose mode to avoid logs truncation
• --recursion-limit, -r INTEGER: Maximum recursion limit for the agent (default: 50)
• --global-prompt, -g: Use the default global prompt even if a local prompt is configured
• --mcp-servers TEXT: Comma-separated list of MCP server names to include in the agent

Examples:

Start the interactive coding assistant

# Default run
codemie-plugins code
# or with uvx
uvx codemie-plugins code

Use a specific model

# gpt-4o example
codemie-plugins code --model gpt-4o
# or with uvx
uvx codemie-plugins code --model gpt-4o

# Claude Sonnet 3.7
codemie-plugins code --model anthropic.claude-3-7-sonnet-20250219-v1:0
# or with uvx
uvx codemie-plugins code --model anthropic.claude-3-7-sonnet-20250219-v1:0

Set a custom temperature

# Configure agent temperature
codemie-plugins code --temperature 0.2
# or with uvx
uvx codemie-plugins code --temperature 0.2

Specify allowed directories to access on local file system

# Specify allowed directories (Absolute path should be provided)
codemie-plugins code --allowed-dir /path/to/project
# or with uvx
uvx codemie-plugins code --allowed-dir /path/to/project

Use with specific LLM service configuration

# Pass api key and url
codemie-plugins code --llm-api-key your-api-key --llm-base-url https://your-llm-service.com
# or with uvx
uvx codemie-plugins code --llm-api-key your-api-key --llm-base-url https://your-llm-service.com

Overwrite default prompt

# Use with a local prompt (overrides default)
codemie-plugins config local-prompt "Your custom prompt"
codemie-plugins code
# or with uvx
uvx codemie-plugins config local-prompt "Your custom prompt"
uvx codemie-plugins code

Force usage of global prompt

# Force using the default global prompt
codemie-plugins code -g
# or with uvx
uvx codemie-plugins code -g

Use MCP servers (should be configured in advance). See Custom MCP Servers section

# Use with MCP servers
codemie-plugins code --mcp-servers jetbrains
# or with uvx
uvx codemie-plugins code --mcp-servers jetbrains

Interactive Mode Commands

Once in the interactive mode, you can use the following commands:

• exit: Exit the interactive mode
• reset: Reset the conversation history

Custom Prompts

You can customize the agent's behavior by providing a custom prompt:

1. Create a file at $HOME/.codemie/prompt.txt with your custom instructions
2. Run the code command, and it will automatically use your custom prompt
3. To force using the default prompt, use the --global-prompt flag

For Development

For local development it's recommended to use default agent with sonnet-3.5 or 3.7 models and point to specific directory to work with. As an example you are developing in $HOME/repos/EPMCDME/codemie and $HOME/repos/EPMCDME/codemie-ui directories. Run the following commands to start codemie-plugins code with claude 3.7 model

codemie-plugins code --allowed-dir $HOME/repos/EPMCDME/codemie --allowed-dir $HOME/repos/EPMCDME/codemie-ui --model anthropic.claude-3-7-sonnet-20250219-v1:0
# or with uvx
uvx codemie-plugins code --allowed-dir $HOME/repos/EPMCDME/codemie --allowed-dir $HOME/repos/EPMCDME/codemie-ui --model anthropic.claude-3-7-sonnet-20250219-v1:0

Custom MCP Servers

You can define custom MCP servers in your global configuration file ($HOME/.codemie/config.json). These servers will be automatically recognized and can be used alongside the predefined servers.

Configuration Format:

{
  "mcpServers": {
    "my-custom-server": {
      "command": "node",
      "args": ["/path/to/server.js"],
      "transport": "stdio"
    }
  }
}

Using Custom Servers:

# List all available servers including custom ones
codemie-plugins mcp list
# or with uvx
uvx codemie-plugins mcp list

# Run a custom server
codemie-plugins mcp run -s my-custom-server
# or with uvx
uvx codemie-plugins mcp run -s my-custom-server

Graceful Shutdown

The CLI implements graceful shutdown handling to ensure that all processes are properly terminated when the CLI is interrupted (e.g., with Ctrl+C). This includes:

• Cancelling running asyncio tasks
• Terminating subprocesses
• Closing connections

Troubleshooting

If you encounter issues with the CLI, try the following:

1. Enable debug mode:

   codemie-plugins --debug COMMAND
   # or with uvx
   uvx codemie-plugins --debug COMMAND
   

2. Check your configuration:

   codemie-plugins config list --all
   # or with uvx
   uvx codemie-plugins config list --all
   

3. Ensure your plugin key is correctly set:

   codemie-plugins config get PLUGIN_KEY
   # or with uvx
   uvx codemie-plugins config get PLUGIN_KEY
   

4. Verify that required environment variables are set for specific servers.

Contributing

Contributions to the CodeMie Plugins CLI are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

© 2025 EPAM AI/Run CodeMie Team