This example demonstrates how to use the Cloud Code SDK for a straightforward AI-assisted coding workflow. It shows how to create a file, read its contents, search for code, and use the AI to improve a Python file.

​
Example: example_usage.py

from cloudcode import Local
import os
# Initialize the SDK with your project directory and API keys
# This must be a git repository if use_git=True (default)
sdk = Local(
    working_dir="/Users/seansullivan/aider-sdk-testing/",
    api_key=os.getenv("CLOUD_CODE_API_KEY")
)

# Create a new file with content
sdk.create_file(
    "src/calculator.py",
    """def add(a, b):
    return a + b

def subtract(a, b):
    return a - b
"""
)

# Read the content of a file
content = sdk.read_file("src/calculator.py")
print("File content:", content)

# Search for a specific string in files
search_results = sdk.search_files("def add", ["src/*.py"])
print("Search results:", search_results)

# Run an AI coding task to improve the calculator
result = sdk.code(
    prompt="Add a multiply and divide function to the calculator.py file. Make sure to handle division by zero in the divide function.",
    editable_files=["src/calculator.py"],
    readonly_files=[]
)

# Check if the operation was successful
if result["success"]:
    print("Coding task was successful!")
    print("Changes made:")
    print(result["diff"])
else:
    print("Coding task failed or made no meaningful changes.")

# To check what content is now in the file after the AI changes
updated_content = sdk.read_file("src/calculator.py")
print("Updated file content:", updated_content)

Note:

  • This example uses the default single-model workflow for simplicity.
  • Make sure to set your CLOUD_CODE_API_KEY environment variable before running.