Skip to content

docs: add Persistent Goals (/goal) feature page#18275

Merged
teknium1 merged 1 commit into
mainfrom
docs/goals-feature-page
May 1, 2026
Merged

docs: add Persistent Goals (/goal) feature page#18275
teknium1 merged 1 commit into
mainfrom
docs/goals-feature-page

Conversation

@teknium1
Copy link
Copy Markdown
Contributor

@teknium1 teknium1 commented May 1, 2026

Summary

Adds a proper feature page for /goal at user-guide/features/goals.md. The slash-command reference table had two rows but no narrative walkthrough, so new users scrolling the command list weren't getting the whole picture.

Covers:

  • What the judge model does + fail-open semantics
  • Turn budget and auto-pause behavior
  • User-message preemption
  • Session persistence (/resume picks up standing goals)
  • Prompt-cache invariants
  • goals.max_turns and per-task aux model override via auxiliary.goal_judge
  • A walkthrough example showing a multi-turn goal running to completion
  • The two judge failure modes (false positive / false negative) and how to recover
  • Full attribution to Codex CLI 0.128.0 / Eric Traut as prior art for the Ralph-loop pattern

Also cross-links both slash-commands.md rows (CLI + gateway) to the new page.

Validation

npx docusaurus build Clean build, 0 new broken anchors. The Auxiliary Models cross-link points to the correct #auxiliary-models anchor on the configuration page.

Docs-only — no code changes.

Adds a proper feature page at user-guide/features/goals.md covering
the /goal slash command — Hermes' take on the Ralph loop shipped in
PR #18262. The slash-commands reference table had two table rows but
no narrative doc walking through the judge model, fail-open semantics,
turn budget, persistence, user-message preemption, or the aux-model
config override.

Adds a walkthrough example showing a multi-turn goal running to
completion, covers the two judge failure modes with how to recover,
and credits Codex CLI 0.128.0 / Eric Traut as prior art.

Also cross-links both slash-commands.md rows to the new page so
readers discovering /goal from the command reference can dive in.
@teknium1 teknium1 merged commit cf2b2d3 into main May 1, 2026
6 of 7 checks passed
@teknium1 teknium1 deleted the docs/goals-feature-page branch May 1, 2026 06:16
@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have comp/cli CLI entry point, hermes_cli/, setup wizard labels May 1, 2026
jooray added a commit to jooray/hermes-agent that referenced this pull request May 1, 2026
* upstream/main: (208 commits)
  fix: kanban button
  fix(telegram): send seed message after creating DM topics (NousResearch#18334)
  fix(yuanbao): enforce owner identity check on group slash commands
  docs(website): add User Stories and Use Cases collage page (NousResearch#18282)
  fix: prevent tui rebuilding assets
  fix(paths): route achievements plugin + profile-tui through HERMES_HOME
  docs: publish llms.txt and llms-full.txt for agent-friendly ingestion (NousResearch#18276)
  docs: add Persistent Goals (/goal) feature page (NousResearch#18275)
  fix(moonshot): also strip nullable/enum after anyOf collapse
  chore(release): map hendrixfreire for moonshot salvage
  fix(moonshot): fill missing type before enum cleanup to handle anyOf branches without explicit type
  chore(release): add mikeyobrien to AUTHOR_MAP
  fix(gateway): honor MATRIX_HOME_ROOM in onboarding
  feat: /goal — persistent cross-turn goals (Ralph loop) (NousResearch#18262)
  docs(sidebar): collapse exploding skills tree to a single Skills node (NousResearch#18259)
  feat(update): add --yes/-y flag to skip interactive prompts (NousResearch#18261)
  feat(gateway): auto-delete slash-command system notices after TTL (NousResearch#18266)
  fix(curator): rewrite cron job skill refs after consolidation (NousResearch#18253)
  fix(deepseek): use non-empty reasoning_content placeholder for V4 Pro thinking mode
  fix(compression): include system prompt + tool schemas in token estimates (NousResearch#18265)
  ...

# Conflicts:
#	tools/tts_tool.py
nickdlkk pushed a commit to nickdlkk/hermes-agent that referenced this pull request May 11, 2026
Adds a proper feature page at user-guide/features/goals.md covering
the /goal slash command — Hermes' take on the Ralph loop shipped in
PR NousResearch#18262. The slash-commands reference table had two table rows but
no narrative doc walking through the judge model, fail-open semantics,
turn budget, persistence, user-message preemption, or the aux-model
config override.

Adds a walkthrough example showing a multi-turn goal running to
completion, covers the two judge failure modes with how to recover,
and credits Codex CLI 0.128.0 / Eric Traut as prior art.

Also cross-links both slash-commands.md rows to the new page so
readers discovering /goal from the command reference can dive in.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants