TeDDy

TeDDy (developed by atte500) is an open-source test-driven execution harness and orchestrator written in Python. It is designed to manage coding agent lifecycles, test execution passes, and debugging loops directly against a local codebase. Operating primarily as a terminal-based execution framework via `teddy_executor`, TeDDy manages runtime test runners, tee I/O capture handlers, and diagnostic output streaming. The orchestrator coordinates validation runs, handles timeout and error recovery stages, and extracts structured execution metrics from development runs. Unlike standalone conversational CLI agents, TeDDy functions as an underlying orchestration harness emphasizing test-driven validation, artifact-based probe mechanisms, and cross-platform pre-commit lifecycle hooks. It provides the execution scaffolding necessary to run, test, and debug agentic code changes systematically. TeDDy is an open-source project hosted on GitHub and is available under standard open-source development workflows.

Tags: cli, codebase, developer tools, experiments, OpenSource

Visit TeDDy

Key features

  • Test-driven execution harness — Coordinates automated test runs and execution loops through teddy_executor to validate code modifications. - Automated debugger orchestration — Manages automated error triage, timeout recovery steps, and execution failure handling. - Artifact-based retrieval probes — Employs automated probe mechanisms to capture and inspect runtime artifacts and environment traces. - Tee I/O stream capture — Implements robust terminal I/O capture with ANSI escape handling and silent fallback mechanisms for reliable logging. - Cross-platform validation hooks — Utilizes Python-based hook scripts ensuring consistent pre-commit and validation runs across Windows, macOS, and Linux.

Use cases

Use Case: Automated Test-Driven Agent Verification A developer executes TeDDy to supervise test execution against code changes, capturing test failures and feeding structured logs into automated remediation routines.

Use Case: Runtime Artifact and State Inspection An engineer configures TeDDy's probe system to extract execution artifacts and runtime diagnostics when debugging complex script failures.

Use Case: Cross-Platform Git Hook Orchestration A team standardizes pre-commit verification and execution pipelines using TeDDy's cross-platform Python hooks across varied developer environments.

Who it is for

TeDDy is designed for Python developers, harness engineers, and system builders seeking an execution orchestrator and test-driven validation framework for automated coding workflows. It is not intended for non-technical users or developers looking for a monolithic turnkey IDE chat extension.

Install guide

Installation TeDDy is distributed as a Python package. Clone the repository and install it in editable mode along with pre-commit hooks: bash git clone https://github.com/atte500/TeDDy.git cd TeDDy pip install -e . pre-commit install

First Run Verify the installation and environment configuration by running the test suite: bash pytest

Example Session Execute the executor module to inspect available commands and run a supervised execution loop: bash python -m teddy_executor --help

Part of CLI Coding Agents

Categories: AI Coding Agents, Developer Tools, Experiments, Resources

Related CLI agents

  • wreckit — wreckit is an open-source CLI agent harness and orchestration framework created by Mike Hostetler. Built using TypeScript and designed around…
  • Continue — Continue is an open-source AI code assistant and agent framework originally developed by the Continue team (continuedev) and recently acquired…
  • Grite — Grite is an open-source terminal coding agent harness developed by Neul Labs. Implemented in Rust, it provides a lightweight command-line…
  • wt — wt is an open-source CLI harness and workspace orchestration tool maintained by Sahil Ahuja on GitHub. It is built to…
  • uacos — UACOS (by developer caotiensinh) is a local-first code intelligence, context-compression, and release-gate toolkit designed to operate as an agent harness…
  • Agent Memory System — Agent Memory System is an open-source agent orchestration harness developed by RavByte-AI. It provides structured memory retention and retrieval mechanisms…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories