How to use when executing all commands in a Docker container

[alterphp]

Hi!

RTK seems very promising. I execute all my dev commands in Docker containers (with Docker Compose), such as :

• docker compose run --rm <CONTAINER_NAME> pdm test for pytest
• docker compose run --rm <CONTAINER_NAME> yarn test for Vitest

Is there a way to configure RTK so that it understands how to handle outputs ?

[pszymkowiak]

RTK works with Docker Compose commands — no need to install RTK inside the container.

Instead of running rtk docker compose run ..., wrap your command with rtk test, rtk err, or rtk summary:

Filter test output (failures only)

rtk test "docker compose run --rm <CONTAINER_NAME> pdm test"
rtk test "docker compose run --rm <CONTAINER_NAME> yarn test"

Filter errors/warnings only

rtk err "docker compose run --rm <CONTAINER_NAME> pdm test"

Generic summary

rtk summary "docker compose run --rm <CONTAINER_NAME> yarn build"

RTK captures stdout/stderr from the host side and applies its filters — the container runs normally, no modifications needed.

I tested this with a simple Vitest setup in Docker Compose (4 tests, 1 intentional failure):

Without RTK — raw docker compose run --rm node npx vitest run (~30 lines):
Container test-rtk-docker-node-run-bb608127e712 Creating
Container test-rtk-docker-node-run-bb608127e712 Created

RUN v3.2.4 /app

❯ math.test.js (4 tests | 1 failed) 6ms
✓ add works 1ms
✓ sub works 0ms
✓ div works 0ms
× div by zero fails 4ms
→ division by zero

⎯⎯⎯⎯⎯⎯⎯ Failed Tests 1 ⎯⎯⎯⎯⎯⎯⎯

FAIL math.test.js > div by zero fails
Error: division by zero
❯ div math.js:4:22
2| export function sub(a, b) { return a - b; }
3| export function div(a, b) {
4| if (b === 0) throw new Error("division by zero");
| ^
5| return a / b;
6| }
❯ math.test.js:17:13

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯

Test Files 1 failed (1)
Tests 1 failed | 3 passed (4)
Start at 08:06:15
Duration 337ms

With RTK — rtk test "docker compose run --rm node npx vitest run" (5 lines):
📊 OUTPUT (last 5 lines):
❯ math.test.js:17:13
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯

[full output: ~/Library/Application Support/rtk/tee/1771401980_test.log]

Also since v0.21.0, rtk docker compose has native support for:

• rtk docker compose ps — compact service list
• rtk docker compose logs [service] — deduplicated logs
• rtk docker compose build [service] — build summary

Try and say if it's good.