+ jHjb(aRt0tRt^RIt^RIt^RIt^RIHtRR.t]^k]!0Rm4t ]^k]!RR04t ]^kRRlt ]!^R7RR l4t R R lt R tR tRRltRRltRRltRRlt!RR]P(4tRtR#)u*Top-level argparse construction for the hermes CLI. Only the top-level parser and the ``chat`` subparser live here. Every other subparser (model, gateway, sessions, …) is built by ``hermes_cli/subcommands/.py`` and wired in ``main._build_cli_parser`` with its ``cmd_*`` handler injected. N) lru_cache-c --continuec$V^8dQhR\/#returnstr)formats"7/home/ubuntu/.hermes/hermes-agent/hermes_cli/_parser.py __annotate__r s K K3 Kc2^RIHpHpV!V!44 R2#)a``~/.hermes/config.yaml`` spelled for the active profile, for help text. ``main._apply_profile_override`` builds this parser (via ``top_level_value_flag_sets``) BEFORE it re-homes the process to the sticky ``active_profile``; ``get_hermes_home()`` would emit the "[HERMES_HOME fallback] ... wrong profile" warning on every ``hermes`` command for that throwaway help string. Read the process home directly: after the override it IS the profile home. display_hermes_homeget_process_hermes_homez /config.yaml)hermes_constantsrrrs r _cfg_pathrsN!"9";< =\ JJr)maxsizecrV^8dQhR\\\,\\,3,/#r)tuple frozensetr )r s"r r r +s(EE533)G#HErc\4^,p\4p\4pVPFXpVP'dVP^8XdK(VPR8XdTMTpVP VP4KZ \ V4\ V43# \d\\3u#i;i)uG(required-value, optional-value) top-level flags, derived from the REAL parser. Introspects ``build_top_level_parser()`` (every option with nargs != 0) so the argv scanners in ``main.py`` (``_first_positional_argv``, ``_apply_profile_override``) can never drift from the argparse surface — the drift that made ``hermes --reasoning high chat …`` misread ``high`` as the subcommand and forced eager plugin discovery. Mirrors the ``update_cmd._holder_value_flags`` precedent, including the handwritten-snapshot fallback for a broken parser import. Cached per process. See #93530. ?) build_top_level_parserset_actionsoption_stringsnargsupdater Exception_VALUE_FLAGS_FALLBACK_OPTIONAL_VALUE_FLAGS_FALLBACK)parserrequiredoptionalactiontargets r top_level_value_flag_setsr)*s E')!, U UooF(((FLLA,=!'!4X(F MM&// 0 & "Ih$777 E$&DDDEsB"B%%B?>B?c\V^8dQhR\\,R\\,/#)rargvr)listr )r s"r r r Ds"  tCy T#Y rc|\4wrW,\UUu0uFwr4V'gKVkK upp,p^pV\V48dgW,pVR8Xd W^,R#VPR4'gWR#TRV9d Wu9dV^,\V48d^M^, pKv.#uuppi)zISubcommand and its arguments, excluding top-level flags and their values.z--N-=)r)PRE_ARGPARSE_INHERITED_FLAGSlen startswith)r+r%r&flag takes_value value_flagsitokens& r command_argvr8Ds24H%Gc(sGc2C$grGc(ssK A c$i- D=A< $$8O #U"u';AD @QQWXX I)ts B8B8c8VP!V/VBpRVnV#)z]``parser.add_argument`` + tag the Action ``inherit_on_relaunch`` for ``hermes_cli.relaunch``.T) add_argumentinherit_on_relaunch)r$argskwargsr's&*, r _inherited_flagr>Ss$  $ 1& 1F!%F Mru[ Examples: hermes Start interactive chat hermes chat -q "Hello" Single query mode hermes --tui Launch the modern TUI (or set display.interface: tui) hermes --cli Force the classic REPL (overrides display.interface: tui) hermes -c Resume the most recent session hermes -c "my project" Resume a session by name (latest in lineage) hermes --resume Resume a specific session by ID hermes --resume latest Resume the most recent session (same as -c) hermes --tui --resume latest --in ./dir Resume ./dir's latest session in the TUI hermes setup Run setup wizard hermes logout Clear stored authentication hermes auth add Add a pooled credential hermes auth list List pooled credentials hermes auth remove

Remove pooled credential by index, id, or label hermes auth reset

[t] Clear exhaustion status for a provider, or one credential hermes auth priority

Move a pooled credential to priority n (0 = tried first) hermes auth refresh

[t] Refresh a pooled OAuth credential and clear its cooldown hermes model Select default model hermes fallback [list] Show fallback provider chain hermes fallback add Add a fallback provider (same picker as `hermes model`) hermes fallback remove Remove a fallback provider from the chain hermes config View configuration hermes config edit Edit config in $EDITOR hermes config set model gpt-4 Set a config value hermes gateway Run messaging gateway hermes gateway install Install gateway background service hermes gateway start Start the installed gateway service hermes gateway stop Stop the gateway service hermes gateway status Show gateway status hermes -p Run any command against a named profile's home (also --profile) — e.g. hermes -p coder gateway stop hermes -s hermes-agent-dev,github-auth hermes -w Start in isolated git worktree hermes sessions list List past sessions hermes sessions browse Interactive session picker hermes sessions rename ID T Rename/title a session hermes logs View agent.log (last 50 lines) hermes logs -f Follow agent.log in real time hermes logs errors View errors.log hermes logs --since 1h Lines from the last hour hermes debug share Upload debug report for support hermes console Open the safe Hermes command console hermes update Update to latest version hermes dashboard Start web UI dashboard (port 9119) hermes dashboard --stop Stop running dashboard processes hermes dashboard --status List running dashboard processes For more help on a command: hermes --help c<V^8dQhR\PRR/#)rr$rNargparseArgumentParser)r s"r r r s(GSGS!8!8GSTGSrc VP\r!V!RRRRR7V!RRRR R R 7V!R R R RR 7V!VRRR RR7V!VRR RR7V!VRR RRR7V!RRR RR7V!RRRR RR 7V!R RR!R"R#7V!R$R%R&R R'R(7V!R)R*R+R,R-R R.R/R07V!R1R2RR!R3R#7V!VR4RR!R5R#7V!VR6R7R8R R9R#7V!VR:RR!R;R#7V!VRRR!R?R#7V!VR@RR!RA\4 RB2R#7V!VRCRR!RDR#7V!VRERR!RFR#7V!VRGRR!RHR#7V!VRIRJRKRR!RLRM7V!VRNRR!ROR#7V!VRPRQRR!RRRM7R #)SzVTop-level (pre-subcommand) flags; ``-m/--provider`` pair with ``-z`` without ``chat``.z --versionz-V store_truezShow version and exitr'help-z --oneshotPROMPTNaOne-shot mode: send a single prompt and print ONLY the final response text to stdout. No banner, no spinner, no tool previews, no session_id line. Tools, memory, rules, and AGENTS.md in the CWD are loaded as normal; approvals are auto-bypassed. Intended for scripts / pipes.metavardefaultrF --usage-filePATHzOne-shot mode only: after the run, write a JSON usage report (estimated cost, token counts, model, api_calls) to PATH. The report is written even when the run fails, so pipelines can always account for spend. No effect outside -z/--oneshot.-m--modelzModel override for this invocation (e.g. anthropic/claude-sonnet-4.6). Applies to -z/--oneshot and --tui. Also settable via HERMES_INFERENCE_MODEL env var.rLrF --provideruProvider override for this invocation (e.g. openrouter, anthropic). Applies to -z/--oneshot and --tui. The persistent provider lives in config.yaml under model.provider — use `hermes setup` or edit the file to change it. --reasoningLEVELzReasoning effort for this invocation: none, minimal, low, medium, high, xhigh, max, or ultra. Overrides agent.reasoning_effort in config.yaml for this run only; the persistent level lives there (or per-model under agent.reasoning_overrides).rLrKrF-t --toolsetszZComma-separated toolsets to enable for this invocation. Applies to -z/--oneshot and --tui.--resume-rSESSIONzResume a previous session by ID or title, or pass 'latest' for the most recent session (workspace-scoped, like -c with no name)--no-restore-cwdF=Don't cd into a resumed session's recorded working directory.r'rLrF--inin_dirDIRzChange into DIR before starting or resuming. Combined with '--resume latest' or -c, the most recent session for DIR's workspace is picked, and the session stays in DIR (skips the recorded-cwd restore).destrKrLrFrr continue_lastrT SESSION_NAME=Resume a session by name, or the most recent if no name givenrbrconstrLrKrF --worktree-wz5Run in an isolated git worktree (for parallel agents)--accept-hookszAuto-approve any unseen shell hooks declared in config.yaml without a TTY prompt. Equivalent to HERMES_ACCEPT_HOOKS=1 or hooks_auto_accept: true in config.yaml. Use on CI / headless runs that can't prompt.--skills-sappendJPreload one or more skills for the session (repeat flag or comma-separate)--yoloDBypass all dangerous command approval prompts (use at your own risk)--pass-session-id3Include the session ID in the agent's system prompt --checkpoints[Enable filesystem checkpoints before destructive file operations (use /rollback to restore)--ignore-user-configIgnore zJ and fall back to built-in defaults (credentials in .env are still loaded)--ignore-ruleszUSkip auto-injection of AGENTS.md, SOUL.md, .cursorrules, memory, and preloaded skills --safe-modeuTroubleshooting mode: disable ALL customizations — user config, AGENTS.md/memory injection, plugins, and MCP servers (implies --ignore-user-config and --ignore-rules)--tui1Launch the modern TUI instead of the classic REPL--native --tui-native tui_nativezEWith --tui: use native terminal scrollback and disable mouse trackingrbr'rLrF--cliGForce the classic prompt_toolkit REPL (overrides display.interface=tui)--devtui_devr)r$add inheriteds& r _add_top_level_flagsrs'((/ T,5LMk8T 79  HJfdIt _aflD UWfmT7 :< lD ik D)T KM< LNXud !#  d4QU%df d< DF f&|U "$ fj$x_a fh|UY[ f),HJ folEpr f,\5Y[M)stv f&|Ujl fmL%~ fglEFH fj.|LbgZ\ fglE\^ fgIlEQSrc8V^8dQhR\P/#rr@)r s"r r r smmh&=&=mrc HVPRRRR7pVP\\PrCpVP 4pVPRRRR7VPR R R R 7V!R RRRRR7V!RRR7V!VRRVRR7V!RRVRR7V!VRVRRR7V!VR R!R"VR#R$7V!VR%VR&R7V!R'R(VR)R*R+7V!R,R-VR.R/R+7V!R0R1RVR2R$7V!R3R4RR5R67V!R7R8R9.R8R:R;R<7V!R=R>R?VR@RA7V!RBRVRCR$7V!RDRERFVRGRH7V!RIRJRKRLRMVRNRORP7V!RQRVRRR$7V!RSRTRVRUR$7V!VRVRVRWR$7V!VRXRVRYR$7V!RZ\ R[R\R]R^7V!R_\R[R`RaRbRc7V!VRdRVReR$7V!VRfRVRgR$7V!VRhRVRi\4 Rj2R$7V!VRkRVRlR$7V!VRmRVRnR$7V!RoR[RpR7V!VRqRVRrR$7V!VRsRtRuRVRvR7V!VRwRVRxR$7V!VRyRzRVR{R7V#)|uThe ``chat`` subparser (also the implicit default command). Flags ALSO declared on the top-level parser use ``default=argparse.SUPPRESS``: for ``hermes -m foo chat`` argparse first sets ``args.model`` from the top-level parser, then dispatches to the chat subparser, which shares the namespace and ``dest`` — a plain ``None`` default would silently clobber the top-level value. SUPPRESS keeps the subparser action a no-op unless the flag is actually passed after the subcommand (tests/hermes_cli/ test_argparse_flag_propagation.py). chatzInteractive chat with the agentz3Start an interactive chat session with Hermes Agent)rF descriptionz-qz--queryzQuery to run. On a real TTY the prompt seeds an interactive session (submitted literally as the first turn); combined with --oneshot or -Q, or on a non-TTY, it answers and exits.)rFz --query-filerNzRead the single query from a file instead of the command line ('-' reads stdin). Safe for arbitrary text: nothing is shell-interpreted, so quotes, $(...), and backticks are preserved verbatim. Mutually exclusive with -q.)rKrFrH oneshot_exitrDFzWith -q/--query-file: answer the query and exit (legacy single-query behavior) instead of seeding an interactive session. Implied on non-TTY stdio and by -Q/--quiet.r~z--imagez5Optional local image path to attach to a single queryrOrPz.Model to use (e.g., anthropic/claude-sonnet-4)rQrVrWz"Comma-separated toolsets to enablerSrTzReasoning effort for this session: none, minimal, low, medium, high, xhigh, max, or ultra. Overrides agent.reasoning_effort for this run only (same levels as the /reasoning slash command).rUrlrkrmrnr]rRzeInference provider (default: auto). Built-in or a user-defined name from `providers:` in config.yaml.z --base-urlbase_urlURLzQOpenAI-compatible endpoint for --provider custom (e.g. http://127.0.0.1:8000/v1).)rbrLrKrFz --api-keyapi_keyKEYz,API key for this launch only; not persisted.z-vz --verbosezVerbose outputz-Qz--quietz~Quiet mode for programmatic use: suppress banner, spinner, and tool previews. Only output the final response and session info.rEz--formattextz stream-json output_formatzOutput format for single-query mode (-q). 'text' prints the final response as plain text (default). 'stream-json' emits newline-delimited JSON events (JSONL), implies --quiet, and cannot be combined with --tui.)choicesrLrbrFrXrY SESSION_IDzXResume a previous session by ID (shown on exit), or 'latest' for the most recent sessionrJr[r\r^r_r`zgChange into DIR before starting or resuming (scopes '--resume latest' / -c lookups to DIR's workspace).rarrrcrTrdrerfz--create-if-missingzWith -c/--continue : if no session matches the name, create a new session with that title and proceed (instead of failing with a not-found error). Programmatic callers that want 'send to this named thread, making it if needed'.rhrizFRun in an isolated git worktree (for parallel agents on the same repo)rjzAuto-approve any unseen shell hooks declared in config.yaml without a TTY prompt (see also HERMES_ACCEPT_HOOKS env var and hooks_auto_accept: in config.yaml).rsrtz --max-turnsNNzbMaximum tool-calling iterations per conversation turn (default: 500, or agent.max_turns in config))typerLrKrFz --run-budgetSECONDS run_budgetaqOptional wall-clock budget in seconds for each conversation run. At 80%% elapsed the agent gets a one-time wrap-up notice, and implicit provider stale timeouts are capped to the remaining budget so one hung call can't consume the run. Unset = off. Also configurable as agent.run_budget_seconds in config.yaml. Intended for one-shot/eval invocations with a hard ceiling.)rrLrKrbrFrorprqrrrurvz and fall back to built-in defaults (credentials in .env are still loaded). Useful for isolated CI runs, reproduction, and third-party integrations.rwzSkip auto-injection of AGENTS.md, SOUL.md, .cursorrules, memory, and preloaded skills. Combine with --ignore-user-config for a fully isolated run.rxuTroubleshooting mode: disable ALL customizations — user config, AGENTS.md/memory injection, plugins, and MCP servers (implies --ignore-user-config and --ignore-rules). Use to isolate whether a problem comes from your setup or from Hermes itself.z--sourcezSession source tag for filtering (default: cli). Use 'tool' for third-party integrations that should not appear in user session lists.ryrzr{r|r}z9Use native terminal scrollback and disable mouse trackingrrrrr) add_parserr:r>rASUPPRESSadd_mutually_exclusive_groupintfloatr) subparsers chat_parserrrr _query_groups& r _build_chat_parserrsU''6I(KK +77(J[J[HC;;=LdI BDnf 02 .u ?A OP k4HCElH3WX k=(G GIk4Hh_ak<z| :x `b )Xu ;=k,GWXi NO V]3V/ y{ D, &(< LNXuh >@ d4QY%dflH AC  d< UW k+L( .0k?<pr Cs qsUD), FHk8L(Y[ k.|XHJ k1,PXY[M*~@ k+L(hi k=xMN DVW k7<FH k:~LQ]goNP k7<\^ k7`` command exists only once the plugin is installed. Top level only; never raises.hermesz[a-z0-9_-]{1,64}N)find_provider_dir)catalog_install_hintmemory)category)re fullmatchplugins.memoryr$hermes_cli.memory_provider_migrationrr!)rrrrs&& r _plugin_command_install_hintrJsX xr||,?GG4 U # /M#EH== sA A AAc<V^8dQhR\R\R\/#)rrrrr )r s"r r r Ys!++c+#+#+rc^RIHpV!W4#)zYWhere a command that left core went (``hermes auth spotify``, ``hermes mcp serve``, ...).)moved_command_hint)hermes_cli.left_core_migrationr)rrrs&& r _moved_command_hintrYsA d **rc6aa]tRtRtoRtV3RltRtVtV;t#)HermesArgumentParseri_u~argparse parser whose unknown-subcommand error is three short lines, not a 70-name dump. Stock argparse prints the full usage block plus ``(choose from 'chat', 'model', …)`` when the first positional is not a registered subcommand. That buries the only useful fact (the word is not a command) and offers no closest match. Every other error keeps the stock usage + message shape. c <\V\P4'Ed]W!P9EdLVP RV RVP R2.p\ P !\V4\VP4^RR7p\VP\V44pV'dRM\VP\V44pV'dVPRV RV 24MFV'dVPV4M,V'd%VPRR PV4 R 24VPR VP R 24VP^R PV4R ,4\SV`=W4R#)z: 'z ' is not a `z ` command.g333333?)ncutoffzThe 'z3' memory plugin is not installed. Install it with: zDid you mean: z, rzRun `z --help` to see all commands. N) isinstancerA_SubParsersActionrrdifflibget_close_matchesr r,rrrmjoinexitsuper _check_value)selfr'rlinescloseinstallmoved __class__s&&& r r!HermesArgumentParser._check_valuehs) fh88 9 9e>>>Y {#eWL :NOE--c%j$v~~:NRS\_`E2499c%jIG!B':499c%j'QE uUG+^_f^ghi U# ~dii.>-?qAB LL5 +HI J IIa5)D0 1 V+r) __name__ __module__ __qualname____firstlineno____doc__r__static_attributes____classdictcell__ __classcell__)r __classdict__s@@r rr_s,,rrc\RR\P\R7p\ V4VP RRRR7pW\ V43#)aBuild the top-level parser, the subparsers action, and the ``chat`` subparser. Returns ``(parser, subparsers, chat_parser)``; the caller wires ``chat_parser.set_defaults(func= cmd_chat)`` and registers further subparsers via ``subparsers.add_parser(...)``. rz:Hermes Agent - AI assistant with tool-calling capabilities)rrformatter_classepilogcommandzCommand to runz )rbrFrK)rrARawDescriptionHelpFormatter _EPILOGUEradd_subparsersr)r$rs r rr|sV" #_ <rOrYrlrVrGr^rPrXrkrHrRrWrSrM)rrrArr functoolsrr0rr"r#rr)r8r>rrrrrrBrrr )rs@r rs  9L\7ZZ )23)2;D,;O1PP K 1EE2 3  lGSTm` + ,822,:>r