@uipath/codedagent-tool

Coded Agent Tool

A command-line tool over uipath-python

Features

• Automatic Python version detection
• Python path caching for improved performance
• Package installation verification
• Interactive command execution support

Commands

setup

Detects Python installation and verifies required package is installed.

uip codedagent setup [options]

Options:

• --force - Force re-detection of Python even if cached

exec

Executes the configured Python package with provided arguments.

uip codedagent exec [args...]

Options:

• --interactive - enable interactive mode

All arguments are passed directly to the Python package.

Configuration

Static Configuration

The following settings are configured in the code and can be overridden via environment variables:

Python Versions

Default: 3.11, 3.12, 3.13

Override with PYTHON_TOOL_PYTHON_VERSIONS environment variable:

# Windows
set PYTHON_TOOL_PYTHON_VERSIONS=3.13,3.12,3.11

# Linux/macOS
export PYTHON_TOOL_PYTHON_VERSIONS=3.13,3.12,3.11

Cache File

The tool uses a cache file (.codedagent-tool-cache.json) to store:

• Detected Python path
• Python version
• Package name
• Last validation timestamp

If the cached Python path no longer exists, will ask user to configure.

uip codedagent init
❌ Invalid config. Python (C:\Users\georgescu.vlad\AppData\Local\Programs\Python\Python311\python.exe) no longer exists.
Run 'uip codedagent setup' to reconfigure.

Examples

# Setup with default package (uipath-python)
uip codedagent setup

# Force re-detection
uip codedagent setup --force

# Setup with custom package via environment variable
export CLOUD_TOOL_PACKAGE_NAME=my-package
uip codedagent setup

# Run package with arguments
uip codedagent run --help
uip codedagent run command --option value

# Interactive command
uip codedagent run interactive-shell

# Override Python versions via environment variable
export PYTHON_TOOL_PYTHON_VERSIONS=3.10,3.11
uip codedagent setup

# Full configuration example
export PYTHON_TOOL_PYTHON_VERSIONS=3.10,3.11,3.12
export CLOUD_TOOL_PACKAGE_NAME=uipath-python
uip codedagent setup
uip codedagent run --version