Agent Breaking Changes_

← Roo Code

Roo Code Roo Code CLI v0.1.2

2026-02-25 · official notes

Summary

• Streaming Deltas: Tool use ask messages (command, tool, mcp) are now streamed as structured deltas instead of full snapshots in json-event-emitter for improved efficiency.
• Task ID Propagation: Task ID is now generated upfront and propagated through runTask/createTask so currentTaskId is available in extension state immediately.
• Custom Tools: Enabled customTools experiment in extension host.

Full notes

## What's New


### Changed

- **Streaming Deltas**: Tool use ask messages (command, tool, mcp) are now streamed as structured deltas instead of full snapshots in json-event-emitter for improved efficiency.
- **Task ID Propagation**: Task ID is now generated upfront and propagated through runTask/createTask so currentTaskId is available in extension state immediately.
- **Custom Tools**: Enabled customTools experiment in extension host.

### Fixed

- **Cancel Recovery**: Wait for resumable state after cancel before processing follow-up messages to prevent race conditions in stdin-stream.
- **Custom Tool Schema**: Provide valid empty JSON Schema for custom tools without parameters to fix strict-mode API validation.
- **Path Handling**: Skip paths outside cwd in RooProtectedController to avoid RangeError.
- **Retry Handling**: Silently handle abort during exponential backoff retry countdown.
- Fixed spelling/grammar and casing inconsistencies.

### Added

- **Telemetry Control**: Added `ROO_CODE_DISABLE_TELEMETRY=1` environment variable to disable cloud telemetry.

## Installation

```bash
curl -fsSL https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/apps/cli/install.sh | sh
```

Or install a specific version:
```bash
ROO_VERSION=0.1.2 curl -fsSL https://raw.githubusercontent.com/RooCodeInc/Roo-Code/main/apps/cli/install.sh | sh
```

## Requirements

- Node.js 20 or higher
- macOS Apple Silicon (M1/M2/M3/M4), Linux x64, or Linux ARM64

## Usage

```bash
# Run a task
roo "What is this project?"

# See all options
roo --help
```

## Platform Support

This release includes binaries for:
- `roo-cli-darwin-arm64.tar.gz` - macOS Apple Silicon (M1/M2/M3)
- `roo-cli-linux-x64.tar.gz` - Linux x64
- `roo-cli-linux-arm64.tar.gz` - Linux ARM64

## Checksums

```
c8919cc89bc99c42d10e21d4a44166ec8ad214d63a9417e558c42154bdfe593c  roo-cli-darwin-arm64.tar.gz
b8ca68de226f8941917e3af04c7d0e9e41d941d074e0b5cdfde2b6a7b0ca0b43  roo-cli-linux-arm64.tar.gz
32309b4cf6d6176d479e44e43be66d7b35014710e91b87048f8db3c6af28c338  roo-cli-linux-x64.tar.gz
```