harness

Manages long-running autonomous agent workflows with persistence, recovery, and dependencies across sessions.

2.7k|308|Updated Jul 17, 2025
One-click install
npx skills add https://github.com/stellarlinkco/myclaude --skill harness-stellarlinkco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness
Source: https://github.com/stellarlinkco/myclaude/tree/main/skills/harness
Command: npx skills add https://github.com/stellarlinkco/myclaude --skill harness-stellarlinkco

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a robust framework for running long-running, autonomous agent tasks that require progress checkpointing, failure recovery, and task dependency management across multiple sessions.

Core Features & Use Cases

  • Progress Persistence: Automatically saves and resumes agent work using harness-progress.txt and harness-tasks.json.
  • Failure Recovery: Implements rollback mechanisms (git reset --hard) and retry strategies for tasks that fail.
  • Task Dependency Management: Ensures tasks are executed in the correct order based on defined dependencies.
  • Concurrency Control: Supports both exclusive and concurrent execution modes for distributed agent work.
  • Use Case: Orchestrate a complex multi-day development process where an agent needs to implement a feature, run tests, refactor code, and generate documentation, ensuring that no work is lost if the agent session is interrupted.

Quick Start

Initialize a new harness project in the current directory by running the command /harness init.

Frequently Asked Questions about harness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate long-running agent workflows without losing progress across sessions?

To automate long-running agent workflows reliably, use a framework that provides automatic progress persistence and checkpointing. This ensures that autonomous tasks save their state to files like harness-tasks.json, allowing execution to resume seamlessly if the session is interrupted.

What is the best way to manage task dependencies in autonomous agent execution?

Managing task dependencies in autonomous agent execution requires a framework that enforces execution order based on defined rules. This ensures complex, multi-stage processes run sequentially or concurrently as needed, preventing out-of-order execution errors in production environments.

How do I recover failed autonomous agent tasks and rollback changes?

Recovering failed autonomous tasks involves using built-in failure recovery mechanisms like git rollback and retry strategies. By executing git reset --hard, the system reverts codebase changes, allowing the agent to safely retry the failed task without corrupting the project state.

Can I run multiple agent tasks concurrently in a distributed environment?

Yes, you can run multiple agent tasks concurrently in a distributed environment using concurrency control. The framework supports both exclusive and concurrent execution modes, allowing distributed agents to work in parallel or lock resources to prevent conflicts during complex operations.

How do I initialize a project for multi-session agent task management?

To initialize a project for multi-session agent task management, run the /harness init command in your current directory. This sets up the necessary configuration files, such as harness-progress.txt and harness-tasks.json, to track state, dependencies, and progress automatically.

Why do I need checkpointing for multi-day autonomous development processes?

Checkpointing is essential for multi-day autonomous development processes because it automatically saves progress at regular intervals. If an agent session crashes or is interrupted, checkpointing prevents data loss by allowing the workflow to resume from the last saved state rather than starting over.