\n\nGrackle environment adapter for managing Docker container environments.\n\n## Overview\n\nThe Docker adapter creates and manages Docker containers running PowerLine. It handles image pulling/building, container lifecycle, git repo cloning, and GPU passthrough. Supports Docker-outside-of-Docker (DooD) via `GRACKLE_DOCKER_NETWORK`. It can also **attach** to a pre-existing, externally-managed container instead of creating one (see [Attach mode](#attach-mode)).\n\n## Configuration\n\n| Field | Type | Default | Description |\n| --------------- | ------------------------ | ---------------------------- | ------------------------------------------------------------------- |\n| `image` | `string` | `\"grackle-powerline:latest\"` | Docker image (ignored in attach mode) |\n| `containerName` | `string` | `\"grackle-\"` | Container name |\n| `localPort` | `number` | auto | Host port mapping |\n| `volumes` | `string[]` | — | Volume mounts (ignored in attach mode) |\n| `env` | `Record` | — | Extra env vars |\n| `repo` | `string` | — | Git repo to clone into `/workspace` (ignored in attach mode) |\n| `gpus` | `string` | — | GPU passthrough (e.g. `\"all\"`) |\n| `attach` | `string` | — | Name/ID of an existing container to attach to (enables attach mode) |\n\n## Attach mode\n\nWhen `attach` is set, the adapter **does not create a container**. It bootstraps PowerLine inside the already-running container via `docker exec` and drives agent sessions there. This is for cases where another tool (e.g. [Coder](https://github.com/coder/coder)) owns the container lifecycle.\n\n- **Lifecycle:** Grackle never creates, stops, or removes the attached container. `stop`/`destroy` only stop the in-container PowerLine process and remove Grackle's own connectivity sidecar — the target container is left untouched.\n- **Connectivity** is resolved in order: (1) shared Docker network (`GRACKLE_DOCKER_NETWORK`) — reach the container by name (DooD/Coder); (2) the container's bridge IP, if reachable directly from the host (typically native Linux); (3) otherwise a Grackle-owned `socat` sidecar that publishes a host loopback port and forwards into the target's network (works on Docker Desktop / Windows / macOS). Override the sidecar image with `GRACKLE_DOCKER_SOCAT_IMAGE` (default `alpine/socat`).\n- **Credentials** are delivered over the PowerLine gRPC connection at task start, so nothing is baked into the container.\n\n```bash\n# Attach to a container another tool created\ngrackle env add my-box --docker --attach my-running-container\ngrackle env provision my-box\n```\n\n## Prerequisites\n\n- Docker installed and running\n- `docker` CLI available on PATH\n- Optional: `gh` CLI for private repo cloning\n- Attach mode: the target container must have Node.js >= 22 and `git` available (PowerLine requirements)\n","readmeFilename":"README.md"}
![\"npm](\"https://img.shields.io/npm/v/@grackle-ai/adapter-docker.svg\")
\n ![\"CI\"](\"https://github.com/nick-pape/grackle/actions/workflows/ci.yml/badge.svg?branch=main\"){kind=icon}
\n ![\"License:](\"https://img.shields.io/badge/License-MIT-yellow.svg\"){kind=icon}
\n![\"Grackle\"](\"https://raw.githubusercontent.com/nick-pape/grackle/main/apps/docs-site/static/img/grackle-logo.png\"){kind=logo}
\n