Updated 3w ago
by USS-Parks
Lamprey-Harness
Local-first, multi-provider coding desktop with Codex-style Steering, task controls, inline artifacts, PR review, tools, skills, MCP, and research.
64 GitHub stars (64)
Steady at 64 stars — no new stars in the 16 days since Sep 30.
- 24 skills (24 skills found in its SKILL.md files)
- 2 forks (2 forks)
- 3w ago last update (Last updated 3w ago)
Install
Skills CLI
npx skills add USS-Parks/Lamprey-Harness
Asks which skills and agents to install. Just one: npx skills add USS-Parks/Lamprey-Harness --skill Context — add -g for every project.
Claude Code
git clone https://github.com/USS-Parks/Lamprey-Harnesscp -r "Lamprey-Harness/skills/context" ~/.claude/skills/
Copies the Context skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add USS-Parks/Lamprey-Harness
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md — showing the first 24 of 31 files.
-
Context
Gather repository context before answering or editing. Use for "what is this repo", "orient me", "preflight", and unfamiliar codebases.
skills/context/SKILL.md on GitHub (opens in a new tab) -
Debug
Reproduce, isolate, fix, and verify bugs. Use for "debug", "this is broken", "fix the bug", and failing tests.
skills/debug/SKILL.md on GitHub (opens in a new tab) -
Fan Out
Use single-model sub-agents for independent angles. Use for "in parallel", "multiple angles", "compare approaches", and broad analysis.
skills/fan-out/SKILL.md on GitHub (opens in a new tab) -
Frontend QA
Exercise local UI changes in the in-app browser. Use for "test the UI", "check the page", "screenshot this", and layout QA.
skills/frontend-qa/SKILL.md on GitHub (opens in a new tab) -
Plan
Plan coding work before editing. Use for "make a plan for", "plan this", "decompose", and similar requests.
skills/plan/SKILL.md on GitHub (opens in a new tab) -
Review
Perform a code-review pass focused on bugs and ship readiness. Use for "review this", "before I ship", "code review", and PR checks.
skills/review/SKILL.md on GitHub (opens in a new tab) -
Verify
Verify recent changes with the right checks. Use for "verify", "did it work", "check the change", and pre-commit validation.
skills/verify/SKILL.md on GitHub (opens in a new tab) -
lamprey-architecture-contract
Lamprey's load-bearing design decisions, the invariants that must hold, what was deliberately deleted, and the honestly-stated weak points. Load before modifying electron/ipc, electron/services, the provider or tool layers, or the renderer stores — or when you need to know WHY the system is shaped the way it is.
.claude/skills/lamprey-architecture-contract/SKILL.md on GitHub (opens in a new tab) -
lamprey-build-and-env
Recreate the Lamprey dev environment from scratch and get past its known traps — Node/Electron/better-sqlite3 ABI story, the ELECTRON_EXEC_PATH dev-server workaround, esbuild antivirus blocks, the tsconfig node/web split, electron-vite and electron-builder specifics. Load when setting up a machine, when npm install / dev server / build fails, or before touching build configuration.
.claude/skills/lamprey-build-and-env/SKILL.md on GitHub (opens in a new tab) -
lamprey-change-control
How changes are classified, gated, approved, committed, and shipped in the Lamprey Harness repo. Load this BEFORE making any change — code, docs, config, or release — or when you see terms like P-SPR, STS, verify gate, era-lock, commit trailer, push policy, or when a commit/push is rejected by a hook.
.claude/skills/lamprey-change-control/SKILL.md on GitHub (opens in a new tab) -
lamprey-config-and-flags
Catalog of every Lamprey configuration axis — AppSettings keys with defaults and readers, inert retired keys, keychain/keys.json, custom models, loop and timeout knobs, environment variables, per-conversation runtime state — plus the exact checklist for adding a setting without breaking the parity-lock test. Load when reading/changing settings.json, adding a setting, or wondering what a flag does…
.claude/skills/lamprey-config-and-flags/SKILL.md on GitHub (opens in a new tab) -
lamprey-database-and-persistence
The Lamprey data layer in depth — lamprey.db schema init and the migration ledger (v1–v18), the safe-migration checklist written in the shadow of the v0.9.2 crash, transactional guarantees, FTS5, the RAG store and sqlite-vec, retention sweeps, backups, and atomic JSON persistence. Load before touching schema-init.ts, db-migrations.ts, conversation-store.ts, rag/store.ts, or when investigating any…
.claude/skills/lamprey-database-and-persistence/SKILL.md on GitHub (opens in a new tab) -
lamprey-debugging-playbook
Symptom-to-triage playbook for the Lamprey Harness's real failure modes — chat sends failing with SQL errors, hung or ghosted turns, loops misfiring or duplicating, provider HTTP errors, malformed tool calls, silently skipping tests, vanished keys/settings, renderer state bleed, dev server exiting instantly. Load when something is broken and you need the fastest discriminating check.
.claude/skills/lamprey-debugging-playbook/SKILL.md on GitHub (opens in a new tab) -
lamprey-diagnostics-and-tooling
How to MEASURE Lamprey instead of eyeballing it — verify-proof and its skip accounting, the smoke scripts, streaming vitals, the events/tool_calls audit tables, the reasoning trace surface, prompt byte measurement, token accounting — plus tested read-only inspection scripts (db-health.cjs, loop-state.cjs) shipped in this skill's scripts/ directory. Load when you need numbers, evidence, or an inci…
.claude/skills/lamprey-diagnostics-and-tooling/SKILL.md on GitHub (opens in a new tab) -
lamprey-docs-and-writing
Maintaining Lamprey's documents of record — CLAUDE.md, DEVLOG.md, README.md, ARCHITECTURE/, PLANNING/ — with the exact DEVLOG entry template, the README-on-every-ship checklist, commit-message house style, the no-slop/no-fake-polish doctrine, and the rules for what may be claimed publicly. Load when writing any DEVLOG/README/plan/commit text, wrapping a phase, or making public claims about the pr…
.claude/skills/lamprey-docs-and-writing/SKILL.md on GitHub (opens in a new tab) -
lamprey-failure-archaeology
The chronicle of every major Lamprey investigation, incident, dead end, rejected fix, and deletion — symptom, root cause, evidence, resolution, status — so nobody re-fights a settled battle or rebuilds something that was deliberately removed. Load when a bug looks familiar, when you find code or docs referencing subsystems you can't locate, or before proposing a fix for anything.
.claude/skills/lamprey-failure-archaeology/SKILL.md on GitHub (opens in a new tab) -
lamprey-loop-reliability-campaign
The executable, decision-gated campaign for Lamprey's hardest live problem — proving loop autonomy (interval / self-paced / autonomous backlog) reliable in real use. Numbered phases with exact commands, expected observations at every gate, a ranked solution menu for failures, fenced-off wrong paths, and a promotion protocol through change control. Load for any loop work: testing, debugging, harde…
.claude/skills/lamprey-loop-reliability-campaign/SKILL.md on GitHub (opens in a new tab) -
lamprey-proof-and-analysis-toolkit
Lamprey's first-principles analysis recipes — "prove it, don't just install it" — each with a worked example from this repo's history: source-lock test construction, documented-vs-wired audits, prompt byte measurement, behavioral smoke playbook design, causal-chain postmortems, native-binding probing, adversarial test inversion, and BASELINE/AFTER measurement docs. Load when you need to establish…
.claude/skills/lamprey-proof-and-analysis-toolkit/SKILL.md on GitHub (opens in a new tab) -
lamprey-provider-and-model-reference
The multi-provider LLM domain pack for Lamprey — OpenAI-compatible streaming across 17 built-in providers (frontier labs, open-source hosts, keyless local runtimes) plus user-defined custom endpoints, per-provider quirks (reasoning field names, Anthropic's compat-layer limits, base-URL overrides), capability flags, the native-vs-fallback tool-calling contract, retry/backoff, retired-model handlin…
.claude/skills/lamprey-provider-and-model-reference/SKILL.md on GitHub (opens in a new tab) -
lamprey-research-frontier
The two open problems where Lamprey could advance the state of the art — the cheap-model harness thesis (harness engineering makes budget models perform like frontier models) and safe local autonomy (unattended desktop loops with hard ceilings and full local audit) — with why current SOTA fails, this repo's specific assets, the first three concrete steps for each, and falsifiable "you have a resu…
.claude/skills/lamprey-research-frontier/SKILL.md on GitHub (opens in a new tab) -
lamprey-research-methodology
The discipline that turns a hunch into an accepted result in Lamprey — the evidence bar (one mechanism explains all observations including negatives, and survives refutation), numbers predicted before running, the full idea lifecycle from hunch to adopted change or documented retirement, and where good ideas historically came from. Load when starting any investigation or improvement effort, or wh…
.claude/skills/lamprey-research-methodology/SKILL.md on GitHub (opens in a new tab) -
lamprey-ship-and-release
How Lamprey runs and ships — run modes, userData layout, Windows release artifacts, the one-command "Bucket" pipeline, macOS/Linux CI mirroring, GitHub publication, CDN purge, and failure recovery. Load when the user says "ship", "release", "tag it", "Bucket", or when a release step fails partway.
.claude/skills/lamprey-ship-and-release/SKILL.md on GitHub (opens in a new tab) -
lamprey-validation-and-qa
What counts as evidence in Lamprey — the layered verify gate, current baseline numbers, the source-lock test pattern, native-skip accounting, the LL and LP smoke playbooks, and the checklist for adding tests. Load before claiming anything works, when writing or modifying tests, when interpreting test/skip counts, or when a gate fails.
.claude/skills/lamprey-validation-and-qa/SKILL.md on GitHub (opens in a new tab) -
example-directory-skill
Demonstrates the directory-mode skill format with a sibling reference file. Used as a template for richer skills that ship supporting docs alongside.
resources/skills/example-directory-skill/skill.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.