Skip to content

feat(honcho): support instance-local config via HERMES_HOME#1962

Closed
erosika wants to merge 4 commits into
NousResearch:mainfrom
erosika:eri/honcho-hermes-home-config
Closed

feat(honcho): support instance-local config via HERMES_HOME#1962
erosika wants to merge 4 commits into
NousResearch:mainfrom
erosika:eri/honcho-hermes-home-config

Conversation

@erosika

@erosika erosika commented Mar 18, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

  • Honcho config resolution now checks $HERMES_HOME/honcho.json first, falling back to ~/.honcho/config.json
  • Enables isolated Hermes instances with independent Honcho credentials, workspaces, and settings
  • Adds optional lightweight startup context for recallMode=tools via toolsStartupContext
  • Wires gateway startup prewarm all the way through to the fresh AIAgent instance created for the next turn
  • Updates hermes honcho setup and related CLI commands to respect host-scoped Honcho config with root fallback, while continuing to write Hermes-owned workflow settings under hosts.hermes
  • Surfaces the active config path plus startup-context status in Honcho CLI output

Notes

  • This PR now includes the stacked tools-startup-context work on top of the original HERMES_HOME instance-local config change
  • No separate PR was opened for the startup-context work; it is intentionally built into this branch/PR
  • .claude/ remains untracked and is not part of this PR

Test plan

  • Targeted Honcho startup-context and CLI write-path tests pass
  • python -m pytest tests/honcho_integration/test_cli.py tests/test_honcho_client_config.py tests/test_honcho_startup_context.py tests/gateway/test_honcho_lifecycle.py -q
  • Broader relevant suite passes:
    python -m pytest tests/honcho_integration/ tests/gateway/ tests/tools/test_honcho_tools.py tests/test_honcho_client_config.py tests/test_honcho_startup_context.py -q
  • Verified $HERMES_HOME/honcho.json is still resolved when present
  • Verified fallback to ~/.honcho/config.json when no instance-local config exists
  • Verified host-scoped writes preserve shared root defaults where intended
  • Verified tools-mode startup snapshot is injected exactly once and gateway reset prewarm is consumed on the next turn

Related meta issue: #2210

@erosika erosika force-pushed the eri/honcho-hermes-home-config branch 3 times, most recently from a96cb73 to 5ad729c Compare March 19, 2026 20:05
@erosika erosika mentioned this pull request Mar 20, 2026
Closed
teknium1 added a commit that referenced this pull request Mar 21, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
e183744 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of #1962 by @erosika.
teknium1 added a commit that referenced this pull request Mar 21, 2026
@teknium1
feat(honcho): host-scoped config writes, toolsStartupContext config f…
4250a2f 
…ield

- hermes honcho setup now writes Hermes-specific settings under
  hosts.hermes instead of stomping shared root defaults.
- Add _effective_value() for host-scoped config resolution with root fallback.
- Add tools_startup_context field to HonchoClientConfig (config only,
  runtime wiring in next commit).
- Setup wizard prompts for startup context toggle.
- cmd_status, cmd_peer, cmd_mode, cmd_tokens all use host-scoped reads.

Part 2 of #1962 by @erosika.
teknium1 added a commit that referenced this pull request Mar 21, 2026
@teknium1
feat(honcho): tools-mode startup context runtime
62e7b18 
- Add fetch_startup_snapshot() to HonchoSessionManager for lightweight
  user representation + peer card retrieval.
- Add _schedule_honcho_startup_prewarm() and _pop_startup_snapshot()
  to AIAgent for background prefetch on session start.
- Wire gateway startup prewarm through reset and agent creation.
- Inject startup context on first turn in tools mode when enabled.
- CLI new_session() triggers prewarm when tools_startup_context is on.

Part 3 of #1962 by @erosika.
@teknium1 teknium1 mentioned this pull request Mar 21, 2026
Merged
erosika and others added 4 commits March 21, 2026 19:05
@erosika
fix(honcho): default session strategy to per-directory
d34ce52 
per-session created a new Honcho session on every run, so cross-session
context (peer card, conclusions, dialectic) was never reused. Default
to per-directory so the same working directory always maps to the same
Honcho session. Users on per-session who want isolation can still set
sessionStrategy: per-session in .honcho.
@erosika
feat(honcho): support instance-local config via HERMES_HOME
1e71ad7 
Honcho config resolution now checks $HERMES_HOME/honcho.json before
falling back to ~/.honcho/config.json, enabling isolated Hermes
instances with independent credentials, workspaces, and settings.
@teyrebaz33 @erosika
feat(honcho): optional lightweight cached startup context for recallM…
798facf 
…ode=tools
@erosika
feat(honcho): finish tools startup context flow
1b5cec5
@erosika erosika force-pushed the eri/honcho-hermes-home-config branch from d285a44 to 1b5cec5 Compare March 21, 2026 23:05
@teknium1

teknium1 commented Mar 21, 2026

Copy link
Copy Markdown
Contributor

Instance-local config (resolve_config_path) and session strategy default merged in #2343. Host-scoped writes and startup context deferred for now. Thanks @erosika!

@teknium1 teknium1 closed this Mar 21, 2026
outsourc-e pushed a commit to outsourc-e/hermes-agent that referenced this pull request Mar 26, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
bb4f0f9 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
angelburgosrosado pushed a commit to angelburgosrosado/hermes-agent that referenced this pull request Apr 27, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
5fc8cc4 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
02356abc pushed a commit to 02356abc/hermes-agent that referenced this pull request May 14, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
7e48b25 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
olympus-terminal pushed a commit to olympus-terminal/hermes-agent that referenced this pull request May 16, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
39d4e28 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
8a50966 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
Egavasyug pushed a commit to Egavasyug/hermes-agent that referenced this pull request Jun 10, 2026
@teknium1
feat(honcho): instance-local config via HERMES_HOME, default session …
87ff753 
…strategy to per-directory

- Add resolve_config_path(): checks $HERMES_HOME/honcho.json first,
  falls back to ~/.honcho/config.json.  Enables isolated Hermes instances
  with independent Honcho credentials and settings.
- Update CLI and doctor to use resolved path instead of hardcoded global.
- Change default session_strategy from per-session to per-directory.

Part 1 of NousResearch#1962 by @erosika.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@erosika @teknium1 @teyrebaz33