konareef

Konareef

Konareef is the developer CLI/TUI for building, publishing, installing, and verifying reefpods.

A reefpod is a versioned agent package anchored by a pod.toml manifest. Konareef gives authors a local workflow for scaffolding a pod, validating its manifest, publishing it to a compatible reef-core deployment, installing published pods, and verifying proof bundles offline.

This public repository contains the developer-facing CLI, TUI, tools, schema, tests, and docs. Internal planning, strategy, pitch, and release-planning material is intentionally excluded from the public mirror.

Current capabilities

• Scaffold a starter reefpod.
• Validate pod.toml v0.1 manifests offline.
• Create publisher identities.
• Publish pods to a compatible reef-core server.
• Install signed pod manifests as a buyer/user.
• Run smoke and lifecycle checks against a reef-core deployment.
• Verify exported proof bundles, including strict and disclosure-policy-aware checks.
• Use the terminal UI components for inspection-oriented workflows.

What needs a server

Authoring is fully offline: pod init, pod validate, and verify run with no network and no server. The commands that publish, install, run, or smoke-test a pod talk to a reef-core deployment — hosted access is in private beta (see "Connecting to a reef-core server" below).

Install

Prebuilt binaries (recommended)

Download the archive for your platform from the latest release, extract, and put konareef on your PATH:

tar -xzf konareef_*_$(uname -s | tr A-Z a-z)_*.tar.gz
install -m 0755 konareef ~/go/bin/konareef   # or: sudo mv konareef /usr/local/bin/
konareef --version

Each release ships darwin (amd64/arm64) and linux (amd64/arm64) archives plus a checksums.txt. Verify with sha256sum -c checksums.txt.

go install

With Go 1.25+ on your PATH:

go install github.com/digitsu/konareef@latest
konareef --version

From source

Requirements: Go 1.25 or newer, and Git.

git clone https://github.com/digitsu/konareef.git
cd konareef
go build -o konareef .
./konareef --version
./konareef --help

Run tests:

go test ./...

Connecting to a reef-core server

The publish/install/run/smoke commands target a reef-core instance. Point the CLI at one with --server <url> or the KONAREEF_SERVER environment variable (default http://localhost:4000); mutating actions also need a session token via --token or KONAREEF_TOKEN. A public hosted reef-core is not yet available — access is currently limited to a private beta.

Quick start: build a hello-world reefpod

Create a pod:

./konareef pod init hello-world

Inspect the generated files:

hello-world/
  pod.toml
  prompts/system.md
  README.md

Validate the manifest:

./konareef pod validate ./hello-world/pod.toml

A minimal manifest looks like this:

pod_spec_version = "0.1"

[pod]
name = "hello-world"
version = "0.1.0"
lineage_id = "0123456789abcdef0123456789abcdef"

[runtime]
kind = "lobster"

[model]
provider = "anthropic"
name = "claude-sonnet-4-5"

[inputs]
name = { type = "string", required = true }

[directive]
template = "./prompts/system.md"

[output]
[[output.failure]]
kind = "timeout_seconds"
value = 600

[budget]
max_sats = 1000

Common commands

# Create a pod skeleton
./konareef pod init hello-world

# Validate a manifest
./konareef pod validate ./hello-world/pod.toml

# Create a publisher identity
./konareef pod identity create --handle alice

# Publish to a reef-core server
./konareef pod publish ./hello-world --server http://localhost:4000

# Publish and expose a public proof bundle endpoint
./konareef pod publish ./hello-world --server http://localhost:4000 --public-bundle

# Install a published pod
./konareef install alice/hello-world
./konareef install alice/hello-world@0.1.0

# Verify a proof bundle
./konareef verify bundle.json
./konareef verify --strict bundle.json
./konareef verify --disclosure-policy C bundle.cbor

# Run smoke checks against a compatible reef-core deployment
KONAREEF_TOKEN=... ./konareef smoke
KONAREEF_TOKEN=... ./konareef smoke --lifecycle

Documentation

Start here:

• docs/reefpods/README.md — reefpod authoring docs index.
• docs/reefpods/build-a-reefpod.md — scaffold, edit, validate, and understand a pod.
• docs/reefpods/publish-run-verify.md — publish, install, smoke-test, and verify flows.
• docs/reference/pod-toml-v0.1.md — current pod.toml language reference.
• docs/reference/pod-definition-of-done.md — current [output] behavior and limitations.
• docs/integration/paygate-client.md — PayGate/ZK runtime client reference.

Repository scope

Konareef owns the developer CLI/TUI, local authoring tools, manifest validation, publishing/install UX, and offline proof verification. reef-core is the compatible server/runtime side that parses and executes pods and serves proof material.

The public mirror is generated from a scrubbed allowlist export and intentionally has a single collapsed release commit. Private project history and non-developer materials are not published.

License

Apache-2.0. See LICENSE.