Agenttrace is an open-source agent harness and tracing orchestrator developed by luoyuctl on GitHub. It is designed to capture, monitor, and manage the execution traces and tool-use lifecycles of autonomous coding agents and LLM-driven workflows. Operating primarily via CLI workflows and plugin integrations (including support for Codex-style environments), Agenttrace intercepts and structures the execution flow of coding agents. It provides visibility into how agentic models invoke tools, inspect code repositories, and produce code modifications across development sessions. What sets Agenttrace apart from general coding assistants is its specialization as a harness and tracing substrate. Rather than solely functioning as an interactive code generator, it focuses on observability, reproducibility, and structured auditing of agent behaviors and automated pipelines. Agenttrace is distributed as an open-source project hosted on GitHub, with CI/CD automation and package distribution workflows configured for environments like WinGet and GHCR.
Agent Execution Tracing — Captures step-by-step logs and traces of autonomous agent tool calls and reasoning loops. - Harness & Orchestration Layer — Manages agent runtime execution across command-line environments and task runners. - Plugin & Codex Integration — Includes configuration surfaces for integration with Codex and related coding agent plugins. - Automated CI/CD Workflows — Maintained with continuous integration pipelines for multiple platform packages including WinGet and GHCR. - Open-Source Tooling — Public repository infrastructure permitting custom extensions and local trace inspection.
Use cases
Use Case: Auditing Agent Tool Interactions Developers running autonomous coding agents can use Agenttrace to record and inspect shell commands, file system reads, and automated edits, ensuring agent actions comply with safety and repository boundaries.
Use Case: Debugging Agentic Failures When an AI coding workflow gets stuck in a loop or produces bad diffs, engineers can evaluate execution traces generated by Agenttrace to pinpoint which tool output or prompt step caused the regression.
Use Case: CI/CD Agent Pipeline Monitoring Teams incorporating automated agent-based patch generation into CI pipelines can leverage Agenttrace to collect structured logs and metrics on agent runs across automated pull request tasks.
Who it is for
Agenttrace is designed for software engineers, AI tooling developers, and DevOps teams building or debugging agentic harnesses and autonomous coding workflows. It is less suitable for casual developers seeking a standalone turnkey conversational chatbot without tracing requirements.
Install guide
Installation Clone the repository directly from GitHub or install via supported package releases: bash git clone https://github.com/luoyuctl/agenttrace.git cd agenttrace(Note: Check repository releases for platform-specific binaries or WinGet package availability as published in CI releases.)
First Run Configure your environment or plugin directory before launching agent trace sessions: bash # Verify repository structure and plugin configs ls -la .codex-plugin
Example Session Run the agent harness to trace an execution session: bash # Execute an agent task within the tracing harness agenttrace run --task "Refactor logging module" --trace-output ./traces/run-01.json
postmortemthis — postmortemthis is an open-source command-line agent harness and orchestration tool developed by Softeria. It orchestrates specialized CLI coding agents and…
claude-cmd — claude-cmd is an open-source command-line interface and workflow harness for Anthropic's Claude, developed by independent open-source developer kiliczsh. The tool…
Contextzip — Contextzip is an open-source command-line optimization harness and utility developed by jee599, built in Rust to manage and compress context…
Claude Code Tools — Claude Code Tools (cctools) is an open-source orchestration harness and plugin distribution toolkit developed by Prasad Chalasani (pchalasani). It is…
Fireconnect — Fireconnect is an open-source CLI orchestration tool developed by Fireworks AI (fw-ai) designed to route various AI coding agents and…
Agent Deck — Agent Deck is an open-source agent harness and terminal-based fleet orchestrator created by Ashesh Goplani. Implemented in Go, it provides…