How nousresearch/hermes-paperclip-adapter works
This repository is a Paperclip adapter that runs Hermes Agent as a managed employee. Paperclip supplies agent configuration and heartbeat work; the adapter builds execution inputs, resolves a model provider, launches Hermes in single-query mode, and returns run results for Paperclip. Separate capabilities expose skill snapshots and configuration/model detection, while UI parsing turns Hermes output into transcript entries. Shared constants support several layers. The README documents the broader run behavior; the shown excerpts do not expose every execution detail, so only documented or source-visible relationships are drawn.
Main entry points: execute.ts Run executor · constants.ts Shared constants · skills.ts Skill APIs · parse-stdout.ts Transcript parser
Components 14
Configuration
- Agent config form
src/ui/build-config.ts - Config builder
src/ui/build-config.ts - Model detection
src/server/detect-model.ts - Adapter metadata
src/index.ts - Shared constants
src/shared/constants.ts
Execution
- Run executor
src/server/execute.ts - Hermes CLI agent
- Session codec
src/server/index.ts
Skills
- Skill APIs
src/server/skills.ts - Paperclip skills
- Hermes skill files
Presentation
- Transcript parser
src/ui/parse-stdout.ts - CLI event formatter
src/cli/format-event.ts
Other components
- Paperclip
Connections 20
- Paperclip → Agent config form: configures
README.md - Agent config form → Config builder: provides values
src/ui/build-config.ts - Paperclip → Run executor: invokes heartbeat
README.md - Run executor → Hermes CLI agent: spawns CLI
src/server/execute.ts - Run executor → Model detection: detects model
src/server/execute.ts - Model detection → Shared constants: uses provider rules
src/server/detect-model.ts - Run executor → Shared constants: uses defaults
src/server/execute.ts - Run executor → Paperclip: reports run results
README.md - Hermes CLI agent → Transcript parser: emits parsed output
README.md - Paperclip → Transcript parser: renders transcript
README.md - Run executor → Session codec: persists session state
README.md - Paperclip → Session codec: validates session state
src/server/index.ts - Paperclip → Skill APIs: requests skill snapshot
README.md - Skill APIs → Paperclip skills: reads managed skills
src/server/skills.ts - Skill APIs → Hermes skill files: scans skill files
src/server/skills.ts - Skill APIs → Paperclip: returns snapshot
README.md - Hermes CLI agent → CLI event formatter: streams events
- Adapter metadata → Shared constants: uses adapter identity
src/index.ts - Config builder → Shared constants: uses defaults
src/ui/build-config.ts - Transcript parser → Shared constants: uses output markers
src/ui/parse-stdout.ts