Agent Breaking Changes_

← Roo Code

Roo Code Roo Code CLI v0.1.17

2026-03-04 · official notes

Summary

• Custom Session ID Support: New --create-with-session-id flag allows specifying a custom UUID session ID when creating tasks. Session IDs are now validated as UUIDs for both create and resume operation
• Added integration coverage for create+resume loading the correct session.
• Installation

Full notes

## What's New


### Added

- **Custom Session ID Support**: New `--create-with-session-id` flag allows specifying a custom UUID session ID when creating tasks. Session IDs are now validated as UUIDs for both create and resume operations, as well as for `start.taskId` in stdin-stream mode.

### Tests

- Added integration coverage for create+resume loading the correct session.

## 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.17 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

```
cf3c1612cd6cd1e50d3db005548a071a634f17a62ca8e8b1ead5a6e832763537  roo-cli-darwin-arm64.tar.gz
d22cf06ccbaf3e9eaed8a9ccebbc4df700e00469390381dfcb33e6af5c672d53  roo-cli-linux-arm64.tar.gz
4f007b9016bb0792943680890f5aa0b52279ee168437100b9f4d32240be5b538  roo-cli-linux-x64.tar.gz
```