v0.6.0 Switchboard

OKF Harness now has a switchboard for installing the shared runtime and native agent integrations from one setup flow, include Claude Code, Codex, OpenCode, Pi, Hermes Agent, and OpenClaw.

Install

macOS and Linux:

curl -fsSL https://okf-harness.dev/install.sh | sh

Windows:

iwr https://okf-harness.dev/install.ps1 | iex

For single-agent native install paths, see the README.

What changed

• Added the universal setup flow through @okf-harness/setup, with Node.js 22+ checks, detected agent integrations, an auditable setup plan, explicit runtime install/update steps, and post-install okfh doctor --json verification.
• Added v0.6 native integration coverage for Claude Code, Codex, OpenCode, Pi, Hermes Agent, and OpenClaw, while keeping the high-frequency okf-harness workflow workspace-local.
• Published @pumblus/okf-harness as the native bootstrap package for host-native installs that need an npm-backed package surface.
• Removed hidden CLI-package postinstall writes, so agent configuration changes now happen through setup or native host installation instead of npm install side effects.
• Expanded release smokes for tarball contents, installer script sources, marketplace installs, OpenCode registry install, and separated runtime/native/legacy/workspace doctor checks.

Notes

• This is the v0.6 install milestone: setup and native integrations are now the primary public install story.
• Node.js 22 or newer is required. Setup does not install Node.js, does not run sudo, and does not create the first OKF Harness workspace.
• Installer scripts are attached to this GitHub Release; native and direct CLI-only commands stay in the docs rather than the release Install section.

v0.5.5 Trail Mix

OKF Harness v0.5.5 closes the v0.5 line with clearer ingest handoffs and adapter-ready internals for the future agent adapters work.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• ingest plan now returns up to five existing non-reference candidate concepts with mechanical match reasons, plus one metadata-only Topic suggestion when no existing content page fits.
• Agent guidance now tells agents how to use candidate concepts and suggested new concepts without treating them as semantic claims.
• Adapter profile data is separated from workflow logic, with shared Claude Code and Codex contract tests for the current adapter surface.
• Package versions, internal dependencies, lockfile, and generated agent-pack golden fixtures are aligned for 0.5.5.

Notes

• No new adapter ships in this release, and there is no adapter plugin system.
• URL sources remain pointers only; the CLI still does not fetch webpages, summarize source bodies, or write wiki content from an ingest plan.
• Publishing, tagging, and GitHub Release creation still require explicit maintainer approval.

v0.5.4 Painted Arrows

OKF Harness v0.5.4 makes workspace next-step guidance easier to hand directly to an agent during the first useful loop.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Tightened status and check Next: prompts for empty, URL-only, local-source, and ready workspaces.
• Kept next steps in the existing single next field, with no new command or schema surface.
• Removed stale version-specific wording from generated ingest guidance.
• Updated package metadata and generated agent-pack golden fixtures for 0.5.4.

Notes

• URL sources remain pointers only; save webpage content as a local file before wiki synthesis.
• This release does not add automatic fetching, repair, scoring, or wiki synthesis.

v0.5.3 Hop the Gap

OKF Harness v0.5.3 makes workspace checks give people the next useful prompt instead of leaving them at raw status output.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• okfh status and okfh check now share one CLI-layer Workspace next-step decision and return it through the existing JSON next field.
• Human-readable status and check output now shows the first next step as Next: ....
• Empty, URL-only, local-source, needs-attention, blocked, and ready workspaces now point toward the next first-loop action.
• English and Chinese CLI/workflow docs now describe Workspace next steps and their boundaries.

Notes

This release does not add an okfh next command, a new public core API, automatic webpage fetching, automatic repair, CLI-generated wiki synthesis, or semantic content scoring. GitHub Release has no extra assets; npm packages are the distribution artifacts.

v0.5.2 First Footstep

OKF Harness v0.5.2 helps a new workspace take its first useful loop from local source material to an evidence-backed first answer.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Added workspace-local first useful loop guidance for source registration, agent-owned wiki synthesis, workspace check, and the short first-answer check.
• Kept bootstrap bounded to setup, source registration, ingest planning, and fresh-session handoff.
• Proved the example workspace path with automated check and evidence coverage.
• Documented the local-file-first flow while keeping URL sources as pointers, not automatically fetched content.

Notes

This is a small first-use completion release, not a new command surface. The CLI still does not synthesize wiki content; agents own semantic wiki edits from registered sources.

v0.5.1 Handrails Up

OKF Harness v0.5.1 hardens the first-start path so a new Codex or Claude Code user gets clearer setup and repair guidance.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Hardened first-start diagnostics for missing, drifted, unmanaged, or unwritable bootstrap entrypoints.
• Tightened current-agent workspace setup boundaries, including nested workspace and unsafe non-empty target refusal.
• Kept setup-plus-source bounded to source registration and ingest planning without writing wiki content.
• Clarified README wording so users choose Codex or Claude Code guidance without implying both are required.

Notes

This is a narrow trust patch for the v0.5 first-start path. It does not add new agent adapters, GUI, cloud sync, background services, vector search, or new answer, ingest, or graph capabilities.

v0.5.0 Drawbridge Down

OKF Harness v0.5.0 lowers the bridge from package install to agent-first workspace setup.

Install

npm install -g @okf-harness/cli

What changed

• Added global okf-harness-bootstrap entrypoints for Codex and Claude Code.
• Kept workspace-local okf-harness as the daily workspace workflow.
• Added deterministic okfh bootstrap install, status, repair, and uninstall tooling for diagnostics.
• Added package-install bootstrap checks, platform refresh hints, setup-plus-source guidance, and updated docs.

Notes

• Package install best-effort installs managed bootstrap entrypoints for detected supported agents.
• The bootstrap path is intentionally thin: setup, workspace discovery or selection, current-agent repair, then handoff into the workspace.

v0.4.0 Lights On

OKF Harness v0.4.0 turns on the Evidence Brief workflow, giving agents bounded wiki evidence before they answer.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Added okfh evidence "<question>" --json for bounded Evidence Briefs from synthesized wiki content.
• Routed Claude and Codex answer guidance through Evidence Briefs before optional bounded reads.
• Added evidence budgets, continuation cues, thin candidates, provenance pointers, and workspace risk limits.
• Kept search/read public as lower-level inspection tools and kept current v0.4 work out of the roadmap.

Notes

This release publishes npm @okf-harness/core, @okf-harness/agent-pack, and @okf-harness/cli 0.4.0 with no extra GitHub release assets.

v0.3.2 Squared Frame

OKF Harness v0.3.2 squares up the frame around v0.3, keeping the CLI command surface and OKF core boundaries easier for agents to follow.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Split CLI command registration into focused command modules.
• Moved OKF document, source ingest, and source metadata behavior behind clearer core boundaries.
• Removed unused MCP scaffold and placeholder fields.
• Aligned the example workspace config and generated adapter fixtures for 0.3.2.

Notes

This is a patch release with no extra GitHub release assets.

v0.3.1 Tight Hinges

OKF Harness v0.3.1 tightens the v0.3 release so install, doctor, check, and generated agent skills match the promises.

Install

npm install -g @okf-harness/cli
okfh doctor --json

What changed

• Accepts legal OKF bundle metadata on root index.md while keeping reserved concept frontmatter blocked.
• Generates validator-ready Claude and Codex skills from shared Markdown templates with 0.3.1 metadata.
• Splits doctor runtime and dev checks, including doctor --dev for repository requirements.
• Verifies npm tarball installs across Linux, macOS, and Windows CI.
• Backs up legacy workflow skills before removing them from discoverable paths.

Notes

• No extra release assets are attached.