Skip to main content

​
CLI

The ahar CLI scaffolds and manages Agent Harnesses.

​
Installation

pip install agentharnesses-cli

​
Commands

​
ahar init

Scaffold a new harness in the current directory: 
ahar init
Optionally specify a name (defaults to the directory name): 
ahar init my-harness
This creates: 
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), ahar init 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.

​
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.