Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 29 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,23 @@
# HRA
# HRA v0

[![HRA](https://hra.sh/opengraph-image)](https://hra.sh)
[![HRA](https://hra-weld.vercel.app/opengraph-image)](https://hra-weld.vercel.app)

**A metaharness for Codex.** HRA turns the Codex accounts you already use into
> [!IMPORTANT]
> This repository preserves HRA v0 and its final v0.1.14 prerelease. The
> current HRA is at [hra.sh](https://hra.sh) with source at
> [github.com/hraness/hra](https://github.com/hraness/hra).

**The original metaharness for Codex.** HRA v0 turns the Codex accounts you already use into
one durable system for planning work, delegating it, running it in parallel,
and bringing it back for review.

[Download for macOS](https://hra.sh/download) · [Website](https://hra.sh) ·
[Compare HRA](https://hra.sh/alternatives) · [Open HRA](https://hra.sh/app)
[Download for macOS](https://hra-weld.vercel.app/download) · [Release history](https://hra-weld.vercel.app/releases) · [Website](https://hra-weld.vercel.app) ·
[Historical comparisons](https://hra-weld.vercel.app/alternatives) · [Current HRA](https://hra.sh)

> HRA 0.1.14 build 15 is a source release candidate for Apple Silicon Macs.
> Direct downloads remain disabled until its exact source commit, annotated
> tag, runtime tree, manifest, checksum, and artifact hashes are published. The
> candidate uses an ad-hoc code seal; it is not Developer ID signed or notarized.
> HRA v0.1.14 build 15 is the final archived prerelease for Apple Silicon Macs.
> Its exact source commit, annotated tag, runtime tree, manifest, checksum, and
> artifact hashes are published. The app uses an ad-hoc code seal; it is not
> Developer ID signed or notarized.

## Why HRA exists

Expand Down Expand Up @@ -49,7 +54,7 @@ worktree manager may be a better fit when model choice or workspace isolation
is the main problem, and a remote client may be better when the main job is
checking an agent from your phone.

The [comparison pages](https://hra.sh/alternatives) explain those tradeoffs
The [comparison pages](https://hra-weld.vercel.app/alternatives) explain those tradeoffs
using current first-party sources, including Codex app, OpenCode Desktop,
Paseo, Conductor, Superset, OpenChamber, and Happy Coder.

Expand Down Expand Up @@ -77,12 +82,18 @@ and data boundary.
## Install the prerelease

The native app targets Apple Silicon and macOS 13 or newer. The
[download page](https://hra.sh/download) exposes no draft asset while the
checked release contract is a candidate. After publication, download the DMG
and checksum from that page, verify the SHA-256, and follow the
unknown-developer instructions. You can build the candidate source locally.
[download page](https://hra-weld.vercel.app/download) exposes the immutable
v0.1.14 build 15 prerelease from the HRA v0 archive. Download the DMG and
checksum there, verify the SHA-256, and follow the unknown-developer
instructions. The tagged candidate source and complete corresponding-source
archives remain attached to that release.

The [release history](https://hra-weld.vercel.app/releases) records every tag
from v0.1.7 through v0.1.14, all seven immutable GitHub prereleases, and every
asset's exact byte count, SHA-256 digest, and archive download link. v0.1.11 is
preserved as a tag-only candidate.

## Develop HRA
## Develop HRA v0

Repository development uses Bun 1.3.14 and Node.js 24. Native work additionally
requires Zig 0.16.0, Xcode Command Line Tools, and an Apple Silicon Mac.
Expand Down Expand Up @@ -124,7 +135,9 @@ corresponding-source artifacts are documented in the

## Project and license

HRA is under active development. It is an independent project and is not
HRA v0 is archived. Security reports and narrowly scoped archival corrections
remain welcome, but feature development continues in the separate
[current HRA repository](https://github.com/hraness/hra). HRA v0 is an independent project and is not
affiliated with, endorsed by, or sponsored by OpenAI. “OpenAI” and “Codex” are
used only to identify the product HRA interoperates with.

Expand Down
12 changes: 7 additions & 5 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Security policy
# HRA v0 security policy

## Report a vulnerability

Report suspected vulnerabilities through [GitHub private vulnerability
reporting](https://github.com/hraness/hra/security/advisories/new). Do not put
reporting](https://github.com/hraness/hra-v0/security/advisories/new). Do not put
an exploit, secret, personal data, or other sensitive detail in a public issue
or discussion.

Expand All @@ -18,9 +18,11 @@ vulnerability details in that issue.

## Supported versions

Security fixes target the current `main` branch. When a published release is
affected, its advisory states which release versions receive a fix. Older
commits and unreleased development snapshots are not supported separately.
HRA v0 is archived at v0.1.14. Maintainers assess reports against the archived
`main` branch and state any available mitigation in the advisory. No new
feature release or automatic update channel is promised. Reports about the
current HRA belong in the separate
[current repository](https://github.com/hraness/hra).

## Disclosure

Expand Down
6 changes: 3 additions & 3 deletions THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Third-party notices
# HRA v0 third-party notices

HRA includes and builds on third-party software and assets. Their license terms
The archived HRA v0 source and final prerelease include and build on third-party software and assets. Their license terms
apply to those components. This summary is informational and does not replace
the license and notice files distributed with each component.

Expand Down Expand Up @@ -56,7 +56,7 @@ and resolved commits are recorded in `package.json` and `bun.lock`.

## PostHog browser SDK

The public `hra.sh` site bundles `posthog-js` 1.412.1 under its declared Apache
The public `hra-weld.vercel.app` site bundles `posthog-js` 1.412.1 under its declared Apache
License 2.0 and MIT terms. Copyright 2020 Posthog / Hiberly, Inc., and copyright
2015 Mixpanel, Inc. The upstream package retains its complete `LICENSE`; the
exact version is recorded in `package.json` and `bun.lock`.
Expand Down
2 changes: 1 addition & 1 deletion apps/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Contents

- `desktop/` – the macOS Native SDK shell, Codex account runtime, and local session dashboard.
- `web/` – the HRA Next.js task control plane, authoritative Convex backend, and `hra.sh` Vercel root.
- `web/` – the archived HRA v0 Next.js task control plane, authoritative Convex backend, and `hra-weld.vercel.app` fallback root.
- `cli/` – the non-interactive `taskctl` client used by humans and agents.

# Guidelines
Expand Down
6 changes: 3 additions & 3 deletions apps/cli/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,12 @@
"license": "Apache-2.0",
"repository": {
"type": "git",
"url": "git+https://github.com/hraness/hra.git",
"url": "git+https://github.com/hraness/hra-v0.git",
"directory": "apps/cli"
},
"homepage": "https://hra.sh",
"homepage": "https://hra-weld.vercel.app",
"bugs": {
"url": "https://github.com/hraness/hra/issues"
"url": "https://github.com/hraness/hra-v0/issues"
},
"type": "module",
"bin": {
Expand Down
Loading