Handoff is an open-source CLI-based agent orchestration harness developed by dazuiba. Distributed as a Python package, it is designed to manage, coordinate, and monitor delegated subagent tasks across automated developer workflows. In daily operations, developers interact with Handoff through its terminal command-line interface (`handoff-cli` / `handoff`). The harness manages asynchronous or background subagent runs, providing structured execution tracking using unique run IDs. It includes operational commands such as `handoff tail` to follow execution output and resume sessions if a delegated task or subagent is interrupted. Handoff differentiates itself by focusing on the session lifecycle and subagent process management rather than just single-turn prompt execution. By maintaining distinct execution states and logging pipelines, it allows developers and automated scripts to delegate execution to subagents (such as Codex-based agents) with error handling and session recovery. Handoff is published as an open-source tool on GitHub and distributed via PyPI.
Tags: cli, code assistant, coding agent, developer tools, OpenSource
RUN_ID). - CLI log tailing — Includes commands like handoff tail to stream live execution logs and progress from running tasks. - PyPI-native distribution — Packaged as a standard Python CLI tool for streamlined installation and workflow automation. - Dual-language documentation — Maintained with comprehensive English and Chinese documentation and release notes.RUN_ID and resume processing without restarting the entire task.handoff tail directly within their terminal session.Handoff is built for software engineers and automation developers orchestrating CLI coding agents and autonomous subagent workflows in the terminal. It is less suited for developers seeking an out-of-the-box conversational GUI editor or a standalone single-agent desktop application.
bash pip install handoff-cli # or pip install handoff Alternatively, install directly from the source repository: bash git clone https://github.com/dazuiba/handoff.git cd handoff pip install -e .bash handoff --help Configure your environment variables and API keys as required by your target subagents (e.g., standard provider keys).bash # Run a delegated agent task handoff run --task "Refactor authentication middleware" # Tail active logs or resume a session by run ID handoff tail <RUN_ID>Part of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools