Skip to content

Commit f331116

Browse files
authored
Update README.md
1 parent 59fe8a7 commit f331116

File tree

1 file changed

+19
-41
lines changed

1 file changed

+19
-41
lines changed

README.md

Lines changed: 19 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,49 @@
11
# docker-git
22

33
`docker-git` создаёт отдельную Docker-среду для каждого репозитория, issue или PR.
4-
5-
Теперь есть API-first controller mode:
6-
- хосту нужен только Docker
7-
- поднимается `docker-git-api` controller container
8-
- его state живёт в Docker volume `docker-git-projects`
9-
- controller через Docker API создаёт и обслуживает дочерние project containers
10-
- снаружи ты общаешься с системой через HTTP API или `./ctl`
4+
По умолчанию проекты лежат в `~/.docker-git`.
115

126
## Что нужно
137

14-
- Для controller mode: Docker Engine или Docker Desktop
8+
- Docker Engine или Docker Desktop
159
- Доступ к Docker без `sudo`
16-
- Node.js и `npm` нужны только для legacy host CLI mode
10+
- Node.js и `npm`
1711

18-
## API Controller Mode
12+
## Установка
1913

2014
```bash
21-
./ctl up
22-
./ctl health
23-
./ctl projects
15+
npm i -g @prover-coder-ai/docker-git
16+
docker-git --help
2417
```
2518

26-
API публикуется на `http://127.0.0.1:3334` по умолчанию.
19+
## Авторизация
2720

2821
```bash
29-
./ctl request GET /projects
30-
./ctl request POST /projects '{"repoUrl":"https://github.com/ProverCoderAI/docker-git.git","repoRef":"main"}'
31-
```
32-
33-
Важно:
34-
- `./ctl` не требует `curl`, `node` или `pnpm` на хосте
35-
- запросы к API выполняются через `curl` внутри controller container
36-
- `.docker-git` больше не обязан лежать на host filesystem: controller хранит его в Docker volume
37-
38-
## Legacy Host CLI
39-
40-
```bash
41-
npm i -g @prover-coder-ai/docker-git
42-
docker-git --help
22+
docker-git auth github login --web
23+
docker-git auth codex login --web
24+
docker-git auth claude login --web
4325
```
4426

4527
## Пример
4628

47-
Через API controller можно создать проект и потом поднять его отдельно:
29+
Можно передавать ссылку на репозиторий, ветку (`/tree/...`), issue или PR.
4830

4931
```bash
50-
./ctl request POST /projects '{"repoUrl":"https://github.com/ProverCoderAI/docker-git.git","repoRef":"main","up":false}'
51-
./ctl projects
32+
docker-git clone https://github.com/ProverCoderAI/docker-git/issues/122 --force --mcp-playwright
5233
```
5334

54-
API возвращает `projectId`, после чего можно:
55-
56-
```bash
57-
./ctl request POST /projects/<projectId>/up
58-
./ctl request GET /projects/<projectId>/logs
59-
./ctl request POST /projects/<projectId>/down
60-
```
35+
- `--force` пересоздаёт окружение и удаляет volumes проекта.
36+
- `--mcp-playwright` включает Playwright MCP и Chromium sidecar для браузерной автоматизации.
6137

62-
## Проверка Docker runtime
38+
Автоматический запуск агента:
6339

6440
```bash
65-
pnpm run e2e:runtime-volumes-ssh
41+
docker-git clone https://github.com/ProverCoderAI/docker-git/issues/122 --force --auto
6642
```
6743

68-
Сценарий доказывает, что контейнер стартует через Docker, runtime state живёт в named volumes, а SSH реально заходит в дочерний project container.
44+
- `--auto` сам выбирает Claude или Codex по доступной авторизации. Если доступны оба, выбор случайный.
45+
- `--auto=claude` или `--auto=codex` принудительно выбирает агента.
46+
- В auto-режиме агент сам выполняет задачу, создаёт PR и после завершения контейнер очищается.
6947

7048
## Подробности
7149

0 commit comments

Comments
 (0)