agentharnesses-cli

CLI for agentharnesses.io — scaffold and manage Agent Harnesses.

Installation

pip install agentharnesses-cli

Usage

ahar --help

ahar init

Initialize a new harness in the current directory:

ahar init

Optionally specify a name (defaults to the directory name):

ahar init my-harness

Scaffolds the following structure:

my-harness/
├── HARNESS.md                       # entry point and agent identity
├── README.md                        # human-facing description
├── .gitignore
├── .claude/settings.json            # registers the harness as a Claude Code plugin
├── skills/
│   └── SKILLS.md                    # skill index
└── references/
    └── REFERENCES.md                # reference index

When using the claude preset (default), also installs:

├── .claude/skills/agent-harnesses/  # metaskill for progressive harness exploration
└── skills/
    └── maintenance/
        ├── SKILLS.md
        └── modify-harness/
            └── SKILL.md

The metaskill is cloned fresh from agentharnesses/metaskill at init time, so you always get the latest version.

ahar validate

Validate a harness directory structure:

ahar validate ./my-harness

ahar read

Read a property from a harness's HARNESS.md frontmatter:

ahar read ./my-harness name
ahar read ./my-harness description

ahar prompt

Render a harness as prompt XML for agent injection:

ahar prompt ./my-harness

These commands are backed by harnesses-ref, the reference implementation for the Agent Harnesses standard.

Publishing

Releases are published to PyPI automatically when a version tag is pushed:

git tag v1.0.0
git push origin v1.0.0

The GitHub Actions workflow builds the package and publishes it via trusted publishing (no API token required). The version is derived from the tag via hatch-vcs.

License

Apache 2.0