Execute AI agent

Run Claude Code or Cursor agent on a running environment.

Project Path Structure

Each environment has a /workspace/ directory where projects live:

When you create an environment with a GitHub repo, it's cloned to /workspace/{sanitized-name}

You can have multiple projects in one environment under /workspace/

Specify only the project name (not full path) - we'll automatically prefix it with /workspace/

Example

If your environment was created with GitHub repo mycompany/backend:

The repo is cloned to: /workspace/backend/

Set projectName: "backend" (just the name, not the full path)

If you create a new project in the environment:

You might create it at: /workspace/new-feature/

Set projectName: "new-feature"

curl --location --request POST 'https://cloudcli.ai/api/v1/agent/execute' \ --header 'X-API-KEY: <api-key>' \ --header 'Content-Type: application/json' \ --data-raw '{ "environmentId": "bded3eef-fa6d-4edf-8299-9f20091a6dd5", "projectName": "MyProject2", "message": "create a hello world", "provider": "claude", "model": "opus" }'

Project Path Structure

Example

Request

Responses

Execute AI agent

Project Path Structure#

Example#

Request

Responses

Project Path Structure

Example