mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-28 15:01:34 +08:00

Files

Teknium 478444c262 feat(checkpoints): auto-prune orphan and stale shadow repos at startup (#16303 )

Every working dir hermes ever touches gets its own shadow git repo under
~/.hermes/checkpoints/{sha256(abs_dir)[:16]}/.  The per-repo _prune is a
no-op (comment in CheckpointManager._prune says so), so abandoned repos
from deleted/moved projects or one-off tmp dirs pile up forever.  Field
reports put the typical offender at 1000+ repos / ~12 GB on active
contributor machines.

Adds an opt-in startup sweep that mirrors the sessions.auto_prune
pattern from #13861 / #16286:

- tools/checkpoint_manager.py: new prune_checkpoints() and
  maybe_auto_prune_checkpoints() helpers.  Deletes shadow repos that
  are orphan (HERMES_WORKDIR marker points to a path that no longer
  exists) or stale (newest in-repo mtime older than retention_days).
  Idempotent via a CHECKPOINT_BASE/.last_prune marker file so it only
  runs once per min_interval_hours regardless of how many hermes
  processes start up.
- hermes_cli/config.py: new checkpoints.auto_prune /
  retention_days / delete_orphans / min_interval_hours knobs.
  Default auto_prune: false so users who rely on /rollback against
  long-ago sessions never lose data silently.
- cli.py / gateway/run.py: startup hooks gated on checkpoints.auto_prune,
  called right next to the existing state.db maintenance block.
- Docs updated with the new config knobs.
- 11 regression tests: orphan/stale deletion, precedence, byte-freed
  tracking, non-shadow dir skip, interval gating, corrupt marker
  recovery.

Refs #3015 (session-file disk growth was fixed in #16286; this covers
the checkpoint side noted out-of-scope there).

2026-04-26 19:05:52 -07:00

docs

feat(checkpoints): auto-prune orphan and stale shadow repos at startup (#16303 )

2026-04-26 19:05:52 -07:00

scripts

chore(skills): remove empty feeds category (#16153 )

2026-04-26 10:44:56 -07:00

src

fix: light mode link/primary colors unreadable on white background (#10457 )

2026-04-15 11:17:44 -07:00

static

chore(models): drop deepseek from OpenRouter and Nous Portal curated picker lists (#16197 )

2026-04-26 12:28:17 -07:00

.gitignore

chore: gitignore generated skills.json

2026-04-02 10:48:15 -07:00

docusaurus.config.ts

docs(site): disable highlightSearchTermsOnTargetPage to keep URLs clean (#12661 )

2026-04-19 11:56:34 -07:00

package-lock.json

docs: stabilize website diagrams

2026-03-14 22:49:57 -07:00

package.json

fix(website): run skill extraction automatically on npm run build/start (#13747 )

2026-04-21 18:02:04 -07:00

README.md

docs: replace ASCII diagrams with Mermaid/lists, add linting note

2026-03-21 17:58:30 -07:00

sidebars.ts

Revert "feat(kanban): durable multi-profile collaboration board (#16081 )" (#16098 )

2026-04-26 08:29:37 -07:00

tsconfig.json

feat: add documentation website (Docusaurus)

2026-03-05 05:24:55 -08:00

README.md

Website

This website is built using Docusaurus, a modern static website generator.

Installation

yarn

Local Development

yarn start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

Using SSH:

USE_SSH=true yarn deploy

Not using SSH:

GIT_USER=<Your GitHub username> yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

Diagram Linting

CI runs ascii-guard to lint docs for ASCII box diagrams. Use Mermaid (````mermaid`) or plain lists/tables instead of ASCII boxes to avoid CI failures.