Local knowledge harness / v0.6.0

Give your agent a local knowledge harness.

OKF Harness helps agent-first knowledge workers keep source material, markdown knowledge, and evidence-backed answers inspectable on their own machine.

Local-first workspace files Terminal-native agent tool surface Apache-2.0 open source
Install OKF Harness View on GitHub

00 / Terminal proof

The workflow is visible in the terminal.

No product mockups are needed here. The public promise is the same one an agent sees: local commands, explicit files, bounded evidence, and checkable output.

Install once

Use the operating-system installer first, then let setup detect supported agents.

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

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

Start from your agent

Ask the agent you already use to create or select a local workspace.

<okf-harness-bootstrap> Set up a workspace
for my AI research notes.

<okf-harness> Add this PDF, update the wiki
with citations, then check the workspace.

Check the result

Agents call deterministic commands when they need evidence or validation.

okfh check --workspace ./ai-research --json
okfh evidence "LLM Wiki" --workspace ./ai-research --json
okfh graph --workspace ./ai-research --json

01 / What it gives your agent

A small harness around ordinary files.

  1. Start from your agentNo separate app to learn.

    Setup exposes a stable OKF Harness entrypoint in supported agents. You ask in natural language; the agent handles the local commands.

  2. Keep knowledge inspectableThe folder stays the center.

    Source copies and hashes live under raw/sources/. Synthesized knowledge lives in ordinary markdown under wiki/, with citations back to reference pages.

  3. Give agents bounded evidenceAnswers begin with a brief.

    The evidence workflow returns selected wiki excerpts and continuation cues before an agent answers. It is not an unbounded raw-source context dump.

  4. Check the workspace, map the graphTrust has a report trail.

    okfh check reports conformance and Harness findings. okfh graph generates a local HTML map so links and references can be inspected.

02 / Product principles

Narrow boundaries make the workflow trustworthy.

  1. 1 Local firstYour workspace is a local folder. OKF Harness does not need accounts, cloud sync, or hosted workspaces for normal use.
  2. 2 No hidden knowledge-base appThe product supports markdown workspaces and agent workflows. It does not replace your editor, notes app, or agent client.
  3. 3 Auditable before automaticInstaller scripts, native install commands, source registration, checks, and graph reports stay visible before they become convenient.

03 / Install

Use the installer path first.

Setup installs or updates the shared okfh runtime after confirmation, detects supported agent clients, and installs the selected native integrations.

macOS or Linux

Recommended for a local terminal.

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

Windows PowerShell

Use the Windows installer route.

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

Already have Node.js 22?

Run setup directly when Node is already available.

npx @okf-harness/setup@latest

Native install paths for supported agents

Use these direct commands when you already know the agent integration you want.

Agent Native install command
Claude Code claude plugin marketplace add pumblus/okf-harness && claude plugin install okf-harness@okf-harness
Codex codex plugin marketplace add pumblus/okf-harness --json && codex plugin add okf-harness@okf-harness --json
OpenCode opencode plugin @pumblus/okf-harness --global
Pi pi install npm:@pumblus/okf-harness
Hermes Agent hermes skills tap add pumblus/okf-harness && hermes skills install pumblus/okf-harness/okf-harness
OpenClaw openclaw skills install @pumblus/okf-harness --global

04 / FAQ

The boundary is part of the product.

Is OKF Harness a knowledge-base app?
No. It is a local harness around markdown workspaces and agent workflows. Your agent remains the interface; the folder remains the source of truth.
Does it upload my source material?
No upload is part of the default workflow. Local files are copied into raw/sources/ and recorded with hashes; URL sources are recorded as pointers.
Which agents are supported?
The current native install table covers Claude Code, Codex, OpenCode, Pi, Hermes Agent, and OpenClaw. Workspace-local guidance is narrower where an agent does not yet expose that surface.
What does setup install?
Setup installs or updates the shared global okfh runtime after confirmation, detects supported agent clients, and installs the native integrations you select.

Need the full command contract? Read the CLI reference.