Metadata-Version: 2.4
Name: agentharnesses-cli
Version: 0.1.5
Summary: CLI tools for agentharnesses.io
Project-URL: Homepage, https://agentharnesses.io
Project-URL: Repository, https://github.com/agentharnesses/cli
License-Expression: Apache-2.0
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: harnesses-ref>=0.1.0
Description-Content-Type: text/markdown

# agentharnesses-cli

CLI for [agentharnesses.io](https://agentharnesses.io) — scaffold and manage Agent Harnesses.

## Installation

```bash
pip install agentharnesses-cli
```

## Usage

```bash
ahar --help
```

### `ahar init`

Initialize a new harness in the current directory:

```bash
ahar init
```

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

```bash
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](https://github.com/agentharnesses/metaskill) at init time, so you always get the latest version.

### `ahar validate`

Validate a harness directory structure:

```bash
ahar validate ./my-harness
```

### `ahar read`

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

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

### `ahar prompt`

Render a harness as prompt XML for agent injection:

```bash
ahar prompt ./my-harness
```

These commands are backed by [harnesses-ref](https://pypi.org/project/harnesses-ref/), the reference implementation for the Agent Harnesses standard.

## Publishing

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

```bash
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
