Coline Docs

Code Execution

Kairo can execute JavaScript code in secure sandboxes. This enables calculations, data processing, and complex automation logic that goes beyond simple tool calls.

What It Is

Code execution runs JavaScript in an isolated environment:

Sandboxed — Code cannot access your data without explicit tools
Ephemeral — No state persists between runs
Fast — Near-instant startup and execution
Safe — Network and system access restricted by default

Use Cases

Data Processing

Transform and analyze data from your workspace:

// Calculate metrics from a sheet
const sheet = await tools.open_resource({
  sourceKind: "file",
  sourceId: "sales-q1"
});
const total = sheet.rows.reduce((sum, row) => sum + row.revenue, 0);
await tools.update_doc({
  docId: "sales-summary",
  content: `Q1 Total: $${total}`
});

Custom Logic

Multi-step workflows in a single execution:

// Close stale tasks
const tasks = await tools.search_tasks({
  status: "in_progress",
  updatedBefore: "30 days ago"
});
for (const task of tasks) {
  await tools.update_task({
    taskId: task.id,
    statusId: "archived"
  });
}

How to Use

From Kairo Chat

Ask Kairo to run code:

"Calculate the average task completion time from the Engineering board"

Kairo will write and execute the code, then return the result.

In Automations

Use code execution in automations for custom logic that processes data or makes decisions.

API

Execute code programmatically via the SDK:

const result = await coline.kairo.execute({
  code: `
    const tasks = await tools.search_tasks({ status: "done" });
    return { count: tasks.length };
  `,
  networkAccess: "block"
});