Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ccdevkit/ccyolo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ccyolo

Run Claude Code in Docker with auto-accept enabled. No setup, full parity with `claude` CLI.

Demo

[!CAUTION] ccyolo is a safety net, not a sandbox. It protects against overzealous agents doing stupid things, but it won't contain a fully compromised, malicious agent. Only use with repositories you trust.

Install

npm install -g @ccdevkit/ccyolo

Usage

Use it exactly like claude:

ccyolo                    # Interactive mode
ccyolo -p "hello"         # One-shot prompt
ccyolo -c                 # Continue previous session
ccyolo -r                 # Resume session picker

All claude flags work as expected.

Why

Works out of the box - no container setup required
Full CLI parity with claude
Runs with auto-accept enabled (YOLO mode)
Your working directory is mounted into the container
Your Claude credentials are passed through automatically

ccyolo flags

ccyolo flags go before --, claude flags go after:

ccyolo -v -- -p "hello"              # Verbose mode
ccyolo --log /tmp/debug.log -- -c    # Log to file
ccyolo --pt git -- -p "git status"   # Run git on host instead of container

Flag	Description
`-v`, `--verbose`	Enable debug logging to stderr
`--log <path>`	Write debug logs to file
`--pt <cmd>`, `--passthrough <cmd>`	Run commands matching prefix on host (repeatable)

Passthrough

By default, all commands run inside the container. This is usually fine, but some commands need to run on your host machine - things like docker, gh, or commands that need access to host resources.

Use --pt to specify command prefixes that should run on the host:

ccyolo --pt git --pt docker -- -p "build and push the image"

This runs git and docker commands on your host, while everything else runs in the container. You can specify --pt multiple times.

Clipboard & Drag-Drop

ccyolo supports pasting images from your clipboard (Ctrl+V / Cmd+V) and dragging files into the terminal, just like the native claude CLI.

How it works

When you paste or drag a file, ccyolo intercepts the input, copies the file into the container via a shared bridge directory, and rewrites the path so Claude sees it correctly.

Platform support

Platform	Clipboard (Ctrl+V)	File drag-drop
macOS (Intel & Apple Silicon)	✅	✅
Linux x64	✅	✅
Windows x64	✅	✅
Linux ARM64	❌	✅
Windows ARM64	❌	✅

Why no clipboard on ARM64? Clipboard image support requires native system APIs (NSPasteboard, Win32, X11) which need CGO compilation. GitHub Actions doesn't provide native ARM64 runners for Linux or Windows, so those builds are cross-compiled without CGO. File drag-drop still works because it only requires path rewriting, not system clipboard access.

If you need clipboard support on ARM64, you can build from source on a native ARM64 machine with CGO enabled.

Requirements

Docker
claude must be authenticated on your machine