Skip to content

CropPilot

CropPilot is CropsCode’s built-in AI assistant. It lives in the orchestrator dashboard and helps you manage workers, launch containers, execute commands, and monitor your farm — all through natural conversation.

  • Launch containers from tickets — “Launch a container for github.com/org/repo/issues/42”
  • Execute commands — “Run npm start in container X” or start long-running processes in the background
  • Open terminals and displays — “Open a terminal on container X” or open a VNC display for GUI interaction
  • Build images — “Build the claude-code-terminal image” with composable capabilities
  • Monitor status — “What’s running on worker-1?” or get details on a specific container
  • Fetch tickets — Pull details from GitHub Issues or Azure DevOps work items
  • Navigate the UI — CropPilot can direct you to any page in the dashboard
  • Read docs — CropPilot can look up CropsCode documentation to answer your questions

CropPilot is an AI agent with access to MCP (Model Context Protocol) tools that control the orchestrator. When you ask it to do something, it:

  1. Interprets your request
  2. Calls the appropriate MCP tools
  3. Confirms the action with you before executing (for destructive operations)
  4. Reports the result
ToolDescription
get_infrastructure_stateGet current workers and containers
get_containerContainer details by ID or name
launch_containerLaunch a container from a ticket URL, empty, or from an existing container
start_containerStart a stopped container
stop_containerStop a running container
remove_containerRemove a container permanently
exec_in_containerExecute a bash command in a running container
exec_in_container_backgroundStart a long-running command via tmux (returns immediately)
list_imagesList available images on a worker
list_capabilitiesList composable image capabilities available on your plan
open_terminalOpen a terminal session in the UI with optional auto-execute commands
open_displayOpen a VNC display session for GUI interaction
navigateNavigate to a page in the dashboard UI
build_imageBuild a composable container image with selected agents and capabilities
fetch_ticketFetch ticket details from a URL (GitHub Issues, Azure DevOps)
read_docsRead CropsCode documentation pages
load_skillLoad a CropPilot skill by name

CropPilot sessions use AI credits from your plan allowance:

PlanMonthly AI Allowance
Starter$2/mo
Pro$6/mo
Enterprise$10/user/mo

You can also bring your own API key (BYOK) to use your own AI provider credentials. See AI Credits.

  • Ask CropPilot to launch a container from a GitHub issue or Azure DevOps ticket
  • Enable host networking when launching to test from your phone at host-ip:port
  • Try: “Open a terminal on container X” to get a live shell
  • CropPilot will confirm launch details with you before creating a container
Getting Started Concepts Guides CLI Self-Hosting Reference Links