Nous Research · Developer & open-source contributor
Building the system.
Connecting the work.
I build Hermes through code, architecture, and technical review. My work connects local failures to the structures that produce them—and makes the reasoning visible in the repository itself.
I’m an official member of the Nous Research Developer Crew. My contribution is currently unpaid; I am not a maintainer. I work alongside maintainers and other contributors, with implementation, review, and original architectural authorship credited separately.
Green checks.
An unproven contract.
In my review of a compression-recovery change, I separated successful CI from a stronger question: does one exact operation retain its identity and reach a truthful outcome across timeout, recovery, and publication?
The argument
The review traces a lost-result race, mismatched profile recovery, stale operation identity, and tests that do not execute the boundary they claim to prove. Each finding names the relevant source and the missing verification.
The contribution
It gives the implementation a precise path to resolution: establish the operation’s contract, test the counterexample at the real boundary, and repeat verification after overlapping work changes the base.
From clusters to constellations
A repository can contain
its own explanation.
The published 5×2×3 method asks analysts to build cluster maps from pinned source regions, then challenges those proposed boundaries through independent inspection. Clustering groups related observations; the engineering question is whether a grouping identifies a coherent responsibility with a defensible extraction seam.
Consistent interlocks made those relationships persistent: a diagnosis links to its architectural law, a review to its implementation, and a correction to the evidence that can verify it. The resulting graph is an authored part of the work, built in public issue and PR comments.
The published cluster-map procedure, page 25, establishes source-guided grouping. The network displayed here uses explicit captured references. Its spatial layout is not a learned clustering result; proximity alone does not establish a dependency.
Explore the graph I composed in Hermes →
Four ways into the work
Twelve failures. One architectural cause.
Follow the twelve issue classes into a common authority model—and back out through the proof required at each boundary.
02 / 5 × 2 × 3↗Independence is part of the design.
The published method for separating analysis, challenge, adjudication, implementation, and fresh review.
03 / Godfile decomposition↗Make the system legible. Preserve its behavior.
Why concentrated responsibility becomes a liability, and how a controlled extraction earns its equivalence claim.
04 / Code review↗Review the claim. Follow the boundary.
Public examples of technical scrutiny: identity, recovery, type continuity, tests, and contributor credit.
From a correction
to the way the repository works.
Axl’s transactional-deployment architecture issue is explicitly named by Teknium’s fleet-update campaign; Teknium then committed its durable invariants into repository AGENTS.md, where the current per-area guide continues to distribute them to coding assistants and contributors.
- 01 / Architecture
#88683 · One transactional deployment plan
Axl’s public architecture issue defines the transactional correction.
Source author: andrexibiza - 02 / Maintainer campaign
#91277 · Fleet update reliability
Phase 2 explicitly identifies #88683 as the architecture ask.
Source author: teknium1 - 03 / Repository guidance commit
2026-08-22 · durable update invariants enter AGENTS.md
The commit adds the update pipeline and failure-class invariants to the shared root instructions, citing #91277.
Source author: teknium1 - 04 / Current routed guidance
hermes_cli/AGENTS.md · Update pipeline
The current guide retains the campaign reference, staged pipeline, generation verification, and machine-readable receipts.
Source author: Repository contributors
This is the distribution mechanism: shared instructions make the invariant available to later contributors and coding assistants without requiring them to rediscover the original issue. The sources establish that transmission; they do not measure obedience by every subsequent actor. Teknium retains authorship of the implementation campaign and guidance commit.
Inspect the current decomposition guidance too
The public root guide also tells contributors to preserve facade/sibling structure, patch the production lookup seam, and split oversized owners. Its September 4 documentation commit belongs to Teknium’s simplification work.
The work continues through other people
Evidence of a shared practice.
Architectural work becomes useful when other contributors can test, challenge, and carry it forward. These public responses show concrete corroboration and follow-through.
teknium1 · #100358 · 2026-09-01
Teknium explicitly corroborates Axl’s earlier review, requires tests through the real prompt builder rather than handwritten fixtures, and identifies a semantic interlock with another model-routing PR.
Read the public response ↗strzhao · #96472 · 2026-08-27
The contributor says Axl’s deterministic harness reproduced the defect and changed the design; the response adds a two-time generation proof, moves wiring through existing owners, and records three explicit interlocks.
Read the public response ↗cervantesh · #97634 · 2026-09-03
The contributor responds to Axl’s exact-object review with function/facade accounting, declared extraction adaptations, contributor lineage, composition order, and exact-head validation receipts.
Read the public response ↗These examples document uptake in particular records. They do not establish that every maintainer uses the same method, or that Axl originated every use of interlocks in the repository.
The contribution library
Follow the work.
Keep the credit.
Every documented contribution story in this site’s Hermes collection is here: implemented code, design and diagnosis, and reviews that shaped other contributors’ work. Open a story for its context, artwork, and original evidence.
29 of 29 contribution stories
Categories follow the credited role and can overlap. The full dataset remains in the participation explorer.
Codebase Simplification — PR #102117
original campaign direction and substantive review
Context & source evidence
This merge completes the godfile-eradication work I started in Hermes Agent. Teknium completed the simplification. My review protected MCP tool schemas through extraction and preserved contributor credit and merge coordination.
The original artwork and PR body report different metrics. Those numbers are reproduced as part of the original artwork; they are not independently measured results. Teknium completed the simplification; my contribution was original campaign direction and substantive review.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Safe Recovery Guidance — PR #101735
credited recovery review integrated by Kshitij
Context & source evidence
Recovery review contributor to safer database-corruption guidance. I caught a recovery command that the actual CLI could not execute; the merged correction provides valid inspect-only or output-based recovery commands and checks them against the real parser. Kshitij integrated salch-cred's original work and the review fixes.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Reliable Compression Across Remote Sessions — PR #100931
credited diagnosis and design trace
Context & source evidence
Diagnosis and design contributor to reliable manual compression. The merged integration credits my design trace with JoaoMarcos44: long-running compute-host compression now reports pending and adopts its late completion, refreshing session state instead of reporting a false timeout. Implementation preserves vsd2807's contribution and Teknium's integration.
My credit is for diagnosis and design tracing. The coauthor credit on the implementation belongs to VVV.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Restoring CI Without Changing Release Policy — PR #100752
review correction adopted and verified
Context & source evidence
Review contributor to restoring CI workflow dispatch without changing release policy. I caught a repair that also re-enabled a deliberately disabled desktop test lane, requested a focused correction, and verified the replacement restored the full job graph while preserving the intended test policy. Teknium authored the fix.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Preserving Useful Background Compression — PR #99742
field validation and safety review
Context & source evidence
Field-validation and safety-review contributor to long-running conversation compression. I supplied Discord evidence of an over-threshold session losing useful compression work, then reviewed the watermark boundary that lets a safe background summary finish without overwriting newer conversation state. Teknium authored the merged implementation.
My contribution covered additional fields and review. The original implementation belongs to the source contributors; other architecture requests remained separate.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Tool Deferral With Essential Capabilities Preserved — PR #97979
rollout and correctness review
Context & source evidence
Reviewed the core-tool deferral rollout against real capability use, schema validation, and compatibility seams. I called for structured clarification to remain immediately visible after Teknium's A/B evaluation showed a regression; the merged change keeps it outside the default deferred set. The implementation and evaluation are Teknium's work.
Teknium conducted the A/B discovery and implemented the change. My contribution was the documented review request.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Process Supervision for MCP — PR #101598
credited process-lifecycle review integrated by Kshitij
Context & source evidence
Review contributor to reliable MCP process supervision. I identified a broken-pipe path that left surviving server groups unguarded and required profile-scoped ownership coverage. Kshitij reproduced and fixed the blocker while integrating jonpol01's shared-supervisor design, preserving supervision across recovery and teardown.
jonpol01 implemented the shared-supervisor optimization. Kshitij owns the follow-ups. My credit concerns the specific blocker and its resolution.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Responsive Credential Exchange — PR #101603
credited concurrency and resource-lifecycle review integrated by Kshitij
Context & source evidence
Review contributor to keeping the dashboard responsive during credential-provider network failures. My feedback added one in-flight exchange per token and cleanup of late HTTP responses, preventing repeated polls from multiplying hung workers or leaking responses. Kshitij implemented the review fixes on peetteerr's original off-loop change.
Single-flight credit is shared with Enough1122; late-response cleanup is credited to me.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Safe Database Shutdown — PR #101118
credited database-safety review adopted by original author
Context & source evidence
Review contributor to safer gateway shutdown. I identified that an expired wait budget still allowed the database to close while a worker could be writing. JoaoMarcos44's merged correction skips that close and checkpoint when gateway-owned workers survive, with a regression test proving the safety boundary.
This change covers the gateway-owned executor. The separate session-hygiene executor remained a documented dependency.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Stable Conversation Identity and Warm AI Caches — PR #100137
technical review
Context & source evidence
My reviews identified identity and lifecycle defects in declared-conversation caching, including cross-source collisions and session rebinding. JoaoMarcos44’s implementation merged with those repairs and co-author credit retained.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Reliable Hermes Installation on Android — PR #100574
credited root-cause analysis and repair strategy
Context & source evidence
Diagnosed the Termux installer's mismatch with Hermes's supported Python range and defined a two-stage repair: provision a supported interpreter first, then validate newer Python as a complete runtime change. The merged installer follows that strategy with compatible-version selection and a Termux User Repository fallback, preserving gustbr's implementation.
My contribution is the analysis and two-stage repair strategy. This record does not establish that Python 3.14 support shipped.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Keeping Credential Exports Out of Source Repositories — PR #100101
credited security review integrated into merged implementation
Context & source evidence
Security review contributor to keeping credential-bearing profile exports out of source repositories and container build contexts. My blocking review led to destination-based path checks, fail-closed export routing, and safer temporary storage. Teknium's merged integration preserves JoaoMarcos44's original implementation and Kshitij's three review fixes.
JoaoMarcos44 authored the original implementation; Kshitij made the review fixes. My contribution was the blocking review.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
One Session, One Writer — PR #99719
technical review
Context & source evidence
My review found two gaps in session ownership: automatic continuation bypassed admission, and unreadable coordination state allowed work to proceed. Futahua’s implementation and the merged follow-up now enforce one writer per session across those paths.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Correct Tool Identity Across xAI Transports — PR #99499
credited design and correctness review integrated into merged fix
Context & source evidence
Review and design contributor to the xAI tool-search repair. I identified alias collisions and lost name provenance across both transports; the merged fix records aliases per request, reverses only names actually emitted, and prevents stale mappings from dispatching the wrong tool. Teknium integrated the original contributions from Git-on-my-level and liuhao1024.
My contribution was the credited blocking review. Implementation authorship remains with the source contributors and Teknium.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Correct Scheduling Across Concurrent Profiles — PR #99496
credited concurrency diagnosis and review integrated into merged fix
Context & source evidence
Identified a concurrency bug that could pair one profile's identity with another profile's timezone and persist the wrong cron schedule. My review called for atomic cache ownership and a real scheduling regression test. The merged integration implements that boundary with a locked per-profile cache, building on qdivan's original fix.
The lock-guarded implementation is Teknium’s follow-up to the linked review.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Authorization for Group Chats Across Gateways — PR #99244
authorization review and verification
Context & source evidence
Authorization reviewer for group chats spanning multiple gateways. I verified that changed execution policy requires fresh approval, replacement grants are checked before publication, and pending work cannot silently acquire new authority. The merged implementation preserves dokterdok's authorship and Teknium's regression coverage.
My contribution was review and verification. Additional integration and architecture requests were separate from the accepted correction.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Shared Credentials Across Profiles and Processes — PR #98245
technical review
Context & source evidence
My reviews traced credential ownership across profiles, persistence, and processes. The merged work preserves JoaoMarcos44’s implementation and adds the cross-process protection and verification repairs those reviews required.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Preserving Images Through Context Compaction — PR #98544
authored implementation integrated by maintainer
Context & source evidence
My fix keeps image-only user messages intact when Hermes compacts conversation history, while enforcing the retention budget and rejecting malformed content. Teknium integrated my original implementation and credited me as the earliest submitter.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Reliable Recurring Tasks in Hermes — PR #98275
authored implementation integrated by maintainer
Context & source evidence
I corrected Hermes's scheduling contract: '30m' creates a recurring interval, while 'in 30m' creates a one-time task. My implementation also handles repeat values such as 'forever' without crashing. Teknium integrated the change.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Consistent Recurring-Task Updates — PR #98290
credited authored design lineage integrated by maintainer
Context & source evidence
Design contributor to consistent recurring-task updates. The merged fix explicitly adopts the shared normalization shape from my original PR, so create and update paths handle repeat values such as forever, once, and numeric strings through one boundary while preserving completion counters and rejecting invalid input. Teknium implemented the integration.
I authored the source design in #77366. This PR is a separate maintainer implementation.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Screenshot Integrity Without Weakening Redaction — PR #97078
technical review
Context & source evidence
My boundary reviews helped turn a screenshot repair into a precise rule: preserve protocol-defined image bytes while continuing to redact sensitive text. liuhao1024’s three commits merged with the requested coverage across binary carriers.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Managed Remote Updates — PR #95942
authored implementation integrated by maintainer
Context & source evidence
My managed SSH update engine was integrated into Hermes Desktop with authorship preserved. It coordinates connection ownership, identity checks, recovery, and update receipts. Teknium adapted the main-process integration.
This record establishes the merged engine and integration. Canary and rollout work in PR #93042 remained separate.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Preserving Saved Logins Through macOS Updates — PR #95283
technical review
Context & source evidence
My review caught repeated deletion of the key protecting gateway and OAuth credentials. DavidMetcalfe’s merged repair preserves that key and verifies signing before reporting success.
The patch hardens the updater. Recurring keychain prompts and the separately tracked Electron migration remain distinct work.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Provenance Checks for Container Updates — PR #95722
authored implementation integrated by maintainer
Context & source evidence
I created the image-provenance marker and reader integrated into Hermes's shared update gate, with my authorship preserved. Image-managed installations now reject unsafe in-place updates across the CLI and dashboard.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Preserving Tool Calls and Their Execution Order — PR #93433
technical review
Context & source evidence
My review required confirmed completion before pending tool calls could execute, correct handling of empty arguments, and preserved call order. cxxCoolStar’s core repair and the merged follow-up close those gaps in streamed Responses output.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Database Repair That Preserves the Original — PR #93353
authored implementation integrated by maintainer
Context & source evidence
My database-repair work moves recovery attempts to an isolated SQLite snapshot and promotes it only after a health check. Failed repair preserves the original data. Teknium integrated this work alongside @fangliquanflq's session-recovery changes.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Reliable Plugin Discovery in Hermes Desktop — PR #92820
authored implementation integrated by maintainer
Context & source evidence
My plugin-discovery fix stops missing Desktop entry points from flooding the console with errors and removes stale registrations when a plugin disappears. Teknium integrated my original implementation with authorship preserved.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Shared Agent Rooms Across Desktops and Gateways — PR #91279
technical review and protocol design influence
Context & source evidence
My technical review drove the revision and compare-and-swap design behind shared Bot Group rooms. TheTom authored the core protocol; Teknium integrated it with room-lifecycle fixes so history syncs across clients, survives gateway loss and cannot revive disbanded rooms.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
Atomic Activation and Connection Safety — PR #89483
technical review integrated into another contributor’s implementation
Context & source evidence
My review surfaced inconsistent desktop activation and failed connection resolution. The merged repair makes activation atomic and rejects failed resolution. jackulau authored the preserved implementation; Teknium integrated it.
The implementation was authored by jackulau.
Thumbnail: project artwork. The full contribution story preserves its caption and context.
No contribution stories match these filters. Try a broader term or show all stories.
Participation in context.
The case studies explain the substance. This dataset makes the breadth, overlap, timing, and source records inspectable.
Different ways of moving a shared project forward.
One person may author, review, and discuss the same record. These bands count distinct records per role; they overlap. Together they cover 2,464 records with direct authorship, review, or discussion activity.
Read the counts precisely
2,938 discussion comments, 205 inline review comments, and 1,208 submitted reviews. The submitted reviews carry GitHub’s COMMENTED state; technical objections in their prose are not recorded as GitHub REQUEST_CHANGES votes. At capture, authored PRs are 308 open, 145 closed without merge, and 1 merged under Axl’s PR authorship. This last count does not include his code integrated through another contributor’s PR. Closed records and raw volume do not measure production impact.
| Month | Count |
|---|---|
| 2026-07 | 3 |
| 2026-08 | 438 |
| 2026-09 | 13 |
2,464 records with direct participation
- Issue #2975 · open[Bug]: WhatsApp bridge only checks on PATH and misses usable macOS runtimescommented
- PR #2983 · openfix(whatsapp): detect usable macOS node runtimescommented
- Issue #3214 · closedfix(cli): NoneType crash on .strip() when config has null YAML valuescommented
- Issue #4351 · openToo many homepagescommented
- Issue #4763 · openfeat(docs): Add Hindi (hi) locale to Docusaurus i18ncommented
- Issue #4814 · closedAdd Hermes Agent logo to official Agent Skills client listcommented
- Issue #5191 · openhermes claw migrate: two silent failures break gateway after OpenClaw migrationcommented
- Issue #5200 · open[docs] Context Files (AGENTS.md/SOUL.md): documented behavior doesn't match codecommented · mentioned
These measurements describe the captured public record, not hours worked, a live contribution ranking, or a causal estimate of defects prevented. Download the measurements and record index · Full capture & coverage