Chunk by CircleCI

Local validation for your agent's code

Chunk gives you everything you need to know your code works before it ever hits CI. Catch what's broken before it leaves your machine.

$ brew install CircleCI-Public/circleci/chunk && chunk init

Get started with Chunk sidecars

  • Sync local code to a Linux microVM and run your tests against it
  • Keep your agent on the rails with hooks and deterministic feedback
  • Works with Claude Code, Cursor, or any AI agent

New to sidecars? Learn more or share feedback on Discord.

> chunk validate
Using sidecar for remote commands
Synchronizing local CircleCI-Public/chunk-cli to remote: /home/user/chunk-cli...
✓ Synced
Running test (remote): task test
✓ internal/anthropic (cached)
✓ internal/config (cached)
ø internal/envspec
✓ acceptance (17.511s)
DONE 975 tests, 2 skipped in 19.078s
Install the Chunk CLI
brew install CircleCI-Public/circleci/chunk
Initialize and authenticate
chunk init
chunk auth set circleci
Run in your agent
/chunk-sidecar

Sidecar usage is currently free. We'll let you know before we start charging.

Use cases

Lightweight, isolated validation on demand

Validate code directly in your agent's loop. Chunk sidecars run microbuilds as the agent loops, providing CI-grade feedback in seconds. Now your agent can self-correct code errors before the push.

01

Prove your code works before CI

Agents commit fast but don't verify it. Chunk sidecars run microbuilds so you catch errors deterministically at speeds up to 78% faster than a full CI run.

02

Run what your laptop shouldn't

Run the heavy stuff in sidecars. Integration suites needing Postgres and Redis, GPU training, full-stack end-to-end, and more.

03

Hand off the grunt work

One-shot any agent task in a sanitary environment: clear up merge conflicts, extend test coverage, verify dependency bumps, etc.

Demo

> Chunk sidecars ensure compounding efficiency

Free on every CircleCI plan, get validation that catches issues early. Fewer retries, less rework, and less unnecessary context fed back to the agent. Catch errors deterministically at speeds up to 78% faster than a full CI run.

$ brew install CircleCI-Public/circleci/chunk && chunk init