dtachwrap 0.1.1

Python wrapper for dtach with built-in binary management

dtachwrap

Python wrapper for dtach with built-in binary management and multi-task CLI. It packages the dtach binary in the wheel (Linux x86_64 / aarch64), so it works out of the box without compilation during installation.

Features

• Portable: Includes pre-compiled dtach binaries (GPL compliant).
• Easy Management: start, attach, ls, logs, stop commands.
• Logging: Automatically captures stdout/stderr to files.
• Recovery: Keeps tasks running even if you disconnect.

Installation

pip install dtachwrap

Or run directly with uvx:

uvx dtachwrap start my-task -- python script.py

Usage

Start a task

dtachwrap start train-exp1 -- python train.py --cfg exp1.yaml

The task runs in the background.

• Socket: ~/.dtachwrap/sockets/train-exp1
• Logs: ~/.dtachwrap/logs/train-exp1.out

List tasks

dtachwrap ls

Shows running tasks. Use dtachwrap ls --all to see stopped tasks.

View logs

dtachwrap logs train-exp1 -f

Attach to a task

dtachwrap attach train-exp1

• Detach key: ^\ (Ctrl+)
• Redraw: Ctrl+l

Stop a task

dtachwrap stop train-exp1

License

This project is licensed under MIT. The bundled dtach binary is GPL-2.0. See src/dtachwrap/_vendor/licenses/DTACH_COPYING.

Development

This project uses uv for dependency management.

1. Setup:

   uv sync
   

2. Run locally:

   uv run dtachwrap --help
   

3. Build:

   uv build