---
title: "Harnie Quick Start"
description: "Import an agent session and create your first cross-agent handoff."
---
## Install

Requires Node.js 22.23 or later:

```bash
curl -fsSL https://boringinfra.company/harnie/install.sh | sh
```

## Import a session

Import from Pi:

```bash
harnie import pi <session.jsonl>
```

Import from OpenCode or Codex using the same pattern with the harness name.

## Inspect work

```bash
harnie show work:pi:cfef1a72-…
```

This shows observed events and derived claims with provenance links.

## Create a handoff

Generate a Markdown continuation package for a different agent:

```bash
harnie handoff work:pi:cfef1a72-… --to opencode
```

The output is a structured Markdown file you can paste into a fresh OpenCode session.

## Supported harnesses

| Harness | Import | Handoff target |
|---------|--------|----------------|
| Pi | Yes | Yes |
| OpenCode | Yes | Yes |
| Codex | Yes | Yes |

## What Harnie does not do

- Resume sessions in the original harness
- Mutate source session files
- Replace your agent's native memory

Harnie observes, structures, and hands off — it does not replay.

## Next steps

- [Use Cases](/docs/products/harnie/use-cases)
- [Product page](https://boringinfra.company/harnie)