postmortemthis is an open-source command-line agent harness and orchestration tool developed by Softeria. It orchestrates specialized CLI coding agents and models to perform automated codebase analysis, failure diagnosis, and postmortem investigations. Operating directly in the terminal, postmortemthis coordinates underlying agent engines—such as xAI's Grok Build (@xai-official/grok), Claude, Antigravity, and OpenRouter-compatible models. It handles agent bootstrapping and runtime isolation, passing non-interactive, read-only flags (such as permission bypass and dontAsk modes) to subordinate CLI binaries to safely inspect logs, repo state, and diffs without interactive prompts. Unlike general-purpose coding assistants aimed at interactive pair-programming and feature generation, postmortemthis serves as a targeted runner for incident reviews and diagnostic sweeps. It abstracts tool bootstrapping via the gg runner ecosystem and automatically routes between native provider keys and OpenRouter endpoints based on backend capabilities. postmortemthis is open source and hosted on GitHub. Model usage and execution costs are dependent on the user's configured provider credentials (e.g., OpenRouter or xAI API keys).
Multi-Agent Orchestration — Dispatches analysis tasks across different coding agents including Grok Build, Claude, and Antigravity. - Dual Backend Routing — Connects to models via OpenRouter or falls back to native provider APIs when tools do not support custom base URLs. - Headless Non-Interactive Runs — Executes downstream CLI tools in headless read-only modes to perform automated diagnostics without manual approval prompts. - gg Ecosystem Integration — Automatically bootstraps, caches, and updates managed agent dependencies through the gg tool runner. - Unified Configuration — Manages credentials and configuration from a central location in ~/.config/postmortemthis/key.
Use cases
Use Case: Automated Root-Cause Analysis Run postmortemthis against a repository after a failed deployment or test suite run to orchestrate agents in read-only mode to trace regressions and log failures.
Use Case: Multi-Agent Architectural Auditing Dispatch multiple AI coding engines across a codebase simultaneously to cross-reference potential bugs, vulnerability vectors, or performance bottlenecks.
Use Case: Non-Interactive CI Diagnostics Embed the harness into automated CI/CD pipeline steps to generate incident summaries and diagnostic logs whenever a build step fails without blocking on user input.
Who it is for
Designed for SREs, DevOps engineers, and backend developers seeking an automated harness to run incident postmortems using multiple CLI agents. It is not designed for users looking for an interactive conversational code assistant or IDE extension.
Install guide
Installation Install postmortemthis via the gg package manager or build directly from source using Cargo: bash # Via gg package manager gg install postmortemthis # Or build from source with Cargo cargo install --git https://github.com/Softeria/postmortemthis
First Run Configure your provider API keys and authenticate the tool: bash # Export provider keys as needed export XAI_API_KEY="your-xai-api-key" export OPENROUTER_API_KEY="your-openrouter-key" # Run initial configuration postmortemthis login
Example Session Run an automated postmortem review on the current working repository: bash # Execute postmortem analysis using available agents postmortemthis
Claude Code Tools — Claude Code Tools (cctools) is an open-source orchestration harness and plugin distribution toolkit developed by Prasad Chalasani (pchalasani). It is…
agenttrace — Agenttrace is an open-source agent harness and tracing orchestrator developed by luoyuctl on GitHub. It is designed to capture, monitor,…
Contextzip — Contextzip is an open-source command-line optimization harness and utility developed by jee599, built in Rust to manage and compress context…
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…
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…