@ccdevkit/ccyolo 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# ccyolo
|
|
2
|
+
|
|
3
|
+
Drop-in replacement for `claude` that runs in a Docker container. Same CLI, no setup.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install -g @ccdevkit/ccyolo
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
## Usage
|
|
12
|
+
|
|
13
|
+
Use it exactly like `claude`:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
ccyolo # Interactive mode
|
|
17
|
+
ccyolo -p "hello" # One-shot prompt
|
|
18
|
+
ccyolo -c # Continue previous session
|
|
19
|
+
ccyolo -r # Resume session picker
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
All `claude` flags work as expected.
|
|
23
|
+
|
|
24
|
+
## Why
|
|
25
|
+
|
|
26
|
+
- Works out of the box - no container setup required
|
|
27
|
+
- Full CLI parity with `claude`
|
|
28
|
+
- Runs with auto-accept enabled (YOLO mode)
|
|
29
|
+
- Your working directory is mounted into the container
|
|
30
|
+
- Your Claude credentials are passed through automatically
|
|
31
|
+
|
|
32
|
+
## ccyolo flags
|
|
33
|
+
|
|
34
|
+
ccyolo flags go before `--`, claude flags go after:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
ccyolo -v -- -p "hello" # Verbose mode
|
|
38
|
+
ccyolo --log /tmp/debug.log -- -c # Log to file
|
|
39
|
+
ccyolo --pt git -- -p "git status" # Run git on host instead of container
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
| Flag | Description |
|
|
43
|
+
|------|-------------|
|
|
44
|
+
| `-v`, `--verbose` | Enable debug logging to stderr |
|
|
45
|
+
| `--log <path>` | Write debug logs to file |
|
|
46
|
+
| `--pt <cmd>`, `--passthrough <cmd>` | Run commands matching prefix on host (repeatable) |
|
|
47
|
+
|
|
48
|
+
### Passthrough
|
|
49
|
+
|
|
50
|
+
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.
|
|
51
|
+
|
|
52
|
+
Use `--pt` to specify command prefixes that should run on the host:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
ccyolo --pt git --pt docker -- -p "build and push the image"
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
This runs `git` and `docker` commands on your host, while everything else runs in the container. You can specify `--pt` multiple times.
|
|
59
|
+
|
|
60
|
+
## Requirements
|
|
61
|
+
|
|
62
|
+
- Docker
|
|
63
|
+
- `claude` must be authenticated on your machine
|