helloagents 2.3.7-beta.1 → 2.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +72 -53
- package/package.json +2 -13
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
|
|
9
9
|
**Let AI go beyond analysis — keep pushing until implementation and verification are done.**
|
|
10
10
|
|
|
11
|
-
[](./pyproject.toml)
|
|
12
12
|
[](https://www.npmjs.com/package/helloagents)
|
|
13
13
|
[](./pyproject.toml)
|
|
14
14
|
[](./helloagents/functions)
|
|
@@ -92,7 +92,7 @@
|
|
|
92
92
|
|
|
93
93
|
**Structured Workflow (Evaluate → Design → Develop)**
|
|
94
94
|
|
|
95
|
-
Every input is scored on five dimensions and routed to R0 direct response, R1 fast flow,
|
|
95
|
+
Every input is scored on five dimensions and routed to R0 direct response, R1 fast flow, or R2 standard flow. R2 enters the full stage chain with explicit entry conditions, deliverables, and verification gates. Supports interactive and fully delegated modes.
|
|
96
96
|
|
|
97
97
|
**Your gain:** proportional effort — simple queries stay fast, complex tasks get full process with verification at every step.
|
|
98
98
|
</td>
|
|
@@ -110,11 +110,11 @@ Keyword scan, semantic analysis, and tool-output inspection catch destructive op
|
|
|
110
110
|
<td width="50%" valign="top">
|
|
111
111
|
<img src="./readme_images/05-feature-icon-compat.svg" width="48" align="left">
|
|
112
112
|
|
|
113
|
-
**
|
|
113
|
+
**Project Knowledge Base**
|
|
114
114
|
|
|
115
|
-
|
|
115
|
+
L1 project knowledge base (structured docs synced from code), context survives across sessions.
|
|
116
116
|
|
|
117
|
-
**Your gain:** context
|
|
117
|
+
**Your gain:** project context persists across sessions — no need to re-explain.
|
|
118
118
|
</td>
|
|
119
119
|
</tr>
|
|
120
120
|
<tr>
|
|
@@ -123,7 +123,7 @@ L0 user memory (global preferences) and L1 project knowledge base (structured do
|
|
|
123
123
|
|
|
124
124
|
**Extensibility & Customization**
|
|
125
125
|
|
|
126
|
-
Voice notifications (5 event sounds),
|
|
126
|
+
Voice notifications (5 event sounds), user-defined tool orchestration (sub-agents, skills, MCP servers, plugins), and flexible configuration options. All features work across 6 CLI targets with graceful degradation.
|
|
127
127
|
|
|
128
128
|
**Your gain:** tailor the workflow to your team's needs without forking the codebase.
|
|
129
129
|
</td>
|
|
@@ -150,14 +150,14 @@ One rule set works across Claude Code, Codex CLI, OpenCode, Gemini CLI, Qwen CLI
|
|
|
150
150
|
| Qwen CLI | Built-in tool calls | Fallback to sequential execution |
|
|
151
151
|
| Grok CLI (Experimental) | Built-in tool calls | Fallback to sequential execution |
|
|
152
152
|
|
|
153
|
-
Additionally, HelloAGENTS provides: **five-dimension routing scoring** (action need, target clarity, decision scope, impact range, EHRB risk) to automatically determine processing depth for each input; **6 CLI targets** (Claude Code / Codex CLI / OpenCode / Gemini CLI / Qwen CLI / Grok CLI) with one rule set across all; **Hooks integration** (Claude Code 11 lifecycle hooks + Codex CLI notify hook + Gemini
|
|
153
|
+
Additionally, HelloAGENTS provides: **five-dimension routing scoring** (action need, target clarity, decision scope, impact range, EHRB risk) to automatically determine processing depth for each input; **6 CLI targets** (Claude Code / Codex CLI / OpenCode / Gemini CLI / Qwen CLI / Grok CLI) with one rule set across all; **Hooks integration** (Claude Code 11 lifecycle hooks + Codex CLI notify hook + Gemini CLI 6 hooks + Grok CLI 3 hooks) with automatic graceful degradation when unavailable.
|
|
154
154
|
|
|
155
155
|
### CLI Compatibility Quick Reference
|
|
156
156
|
|
|
157
157
|
| CLI | Recommended Version | Key Features | Configuration Notes |
|
|
158
158
|
|-----|-------------------|--------------|---------------------|
|
|
159
|
-
| **Claude Code** | Latest | Agent Teams, 11 lifecycle hooks
|
|
160
|
-
| **Codex CLI** | 0.110+ | spawn_agent, CSV batch,
|
|
159
|
+
| **Claude Code** | Latest | Agent Teams, 11 lifecycle hooks | Requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` for teams mode |
|
|
160
|
+
| **Codex CLI** | 0.110+ | spawn_agent, CSV batch, enable_fanout | Enable sub-agents, CSV orchestration, set `project_doc_max_bytes >= 131072` |
|
|
161
161
|
| **OpenCode** | Latest | Task tool, custom agents, MCP | Supports primary agents (build/plan) + subagents (general/explore) |
|
|
162
162
|
| **Gemini CLI** | Latest | Built-in tool calls | Sequential execution fallback |
|
|
163
163
|
| **Qwen CLI** | Latest | Built-in tool calls | Sequential execution fallback |
|
|
@@ -170,14 +170,14 @@ Additionally, HelloAGENTS provides: **five-dimension routing scoring** (action n
|
|
|
170
170
|
- Enable sub-agents and CSV orchestration features
|
|
171
171
|
- Set `project_doc_max_bytes = 131072` in config.toml
|
|
172
172
|
- Configure `developer_instructions` for routing protocol priority
|
|
173
|
-
- Enable `
|
|
173
|
+
- Enable `enable_fanout` for CSV batch orchestration (v0.110+)
|
|
174
174
|
- Configure `nickname_candidates` for agent role identification
|
|
175
175
|
- Configure CSV batch processing if using parallel workflows
|
|
176
176
|
|
|
177
177
|
**Claude Code Setup:**
|
|
178
178
|
- Set `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` environment variable for Agent Teams
|
|
179
179
|
- 11 lifecycle hooks auto-configured during installation (SessionStart, UserPromptSubmit, SubagentStart/Stop, PostToolUse, Stop, TeammateIdle, PreCompact, PreToolUse, SessionEnd, PostToolUseFailure)
|
|
180
|
-
- Auto-memory feature
|
|
180
|
+
- Auto-memory feature disabled during installation (prevents conflicts with AGENTS.md rules)
|
|
181
181
|
|
|
182
182
|
**Other CLIs:**
|
|
183
183
|
- OpenCode supports Task tool with primary agents (build/plan) and subagents (general/explore)
|
|
@@ -322,11 +322,11 @@ Additionally, HelloAGENTS provides: **five-dimension routing scoring** (action n
|
|
|
322
322
|
> - `agent_max_depth = 1` — limits sub-agent nesting depth, recommend keeping default or ≥2
|
|
323
323
|
> - `agent_max_threads` too low — default 6, lower values limit parallel sub-agent scheduling (CSV batch mode recommends ≥16)
|
|
324
324
|
> - `[features]` `multi_agent = true` — must be enabled for sub-agent orchestration to work
|
|
325
|
-
> - `[features]` `
|
|
325
|
+
> - `[features]` `enable_fanout = true` — must be enabled for CSV batch orchestration (spawn_agents_on_csv)
|
|
326
326
|
> - Collab sub-agent scheduling requires Codex CLI feature gate to be enabled
|
|
327
327
|
>
|
|
328
328
|
> 💡 **Best practices:**
|
|
329
|
-
> - Codex 0.110+ recommended for full feature set (
|
|
329
|
+
> - Codex 0.110+ recommended for full feature set (enable_fanout, nickname_candidates)
|
|
330
330
|
> - HelloAGENTS is optimized for Codex CLI — supports `high` and below reasoning effort levels. `xhigh` reasoning is **not supported** and may cause instruction-following issues
|
|
331
331
|
> - Use the terminal/CLI version of Codex for the best experience. The VSCode extension updates lag behind the CLI — newer features (e.g., CSV batch orchestration, Collab multi-agent) may require waiting for the extension to catch up
|
|
332
332
|
|
|
@@ -361,13 +361,7 @@ Additionally, HelloAGENTS provides: **five-dimension routing scoring** (action n
|
|
|
361
361
|
|
|
362
362
|
## Configuration
|
|
363
363
|
|
|
364
|
-
Customize workflow behavior via
|
|
365
|
-
|
|
366
|
-
**Storage locations (highest priority first):**
|
|
367
|
-
|
|
368
|
-
1. Project-level: `{project_root}/.helloagents/config.json` — current project only
|
|
369
|
-
2. Global: `~/.helloagents/config.json` — all projects
|
|
370
|
-
3. Built-in defaults
|
|
364
|
+
Customize workflow behavior via `~/.helloagents/helloagents.json` after installation. Only include keys you want to override — missing keys use defaults.
|
|
371
365
|
|
|
372
366
|
**Available keys:**
|
|
373
367
|
|
|
@@ -376,9 +370,10 @@ Customize workflow behavior via `config.json` after installation. Only include k
|
|
|
376
370
|
| `OUTPUT_LANGUAGE` | string | `zh-CN` | Language for AI output and KB files |
|
|
377
371
|
| `KB_CREATE_MODE` | int | `2` | KB creation: `0`=OFF, `1`=on-demand (prompt ~init), `2`=auto on code changes, `3`=always auto |
|
|
378
372
|
| `BILINGUAL_COMMIT` | int | `1` | Commit language: `0`=OUTPUT_LANGUAGE only, `1`=OUTPUT_LANGUAGE + English |
|
|
379
|
-
| `EVAL_MODE` | int | `1` | Clarification mode: `1`=progressive (1 question/round, max
|
|
373
|
+
| `EVAL_MODE` | int | `1` | Clarification mode: `1`=progressive (1 question/round, max 4), `2`=one-shot (all at once, max 2) |
|
|
380
374
|
| `UPDATE_CHECK` | int | `72` | Update check cache TTL in hours: `0`=OFF |
|
|
381
375
|
| `CSV_BATCH_MAX` | int | `16` | CSV batch max concurrency: `0`=OFF, cap 64 (Codex CLI only) |
|
|
376
|
+
| `notify_level` | int | `0` | Notification mode: `0`=OFF, `1`=desktop, `2`=sound, `3`=desktop+sound |
|
|
382
377
|
|
|
383
378
|
**Example:**
|
|
384
379
|
|
|
@@ -446,7 +441,7 @@ Skip version update checks entirely (not recommended for production use).
|
|
|
446
441
|
"EVAL_MODE": 2
|
|
447
442
|
}
|
|
448
443
|
```
|
|
449
|
-
Ask all clarification questions at once (max
|
|
444
|
+
Ask all clarification questions at once (max 2 rounds) instead of progressive mode (1 question per round, max 4).
|
|
450
445
|
</details>
|
|
451
446
|
|
|
452
447
|
## How It Works
|
|
@@ -515,24 +510,24 @@ When `~auto` or `~plan` presents its confirmation, you choose:
|
|
|
515
510
|
- **Delegated (fully automatic):** auto-advances all stages, auto-selects recommended options, only pauses on EHRB risk
|
|
516
511
|
- **Plan-only delegated:** fully automatic but stops after design, never enters development
|
|
517
512
|
|
|
518
|
-
Without `~` commands, plain-text input is automatically routed to R0–
|
|
513
|
+
Without `~` commands, plain-text input is automatically routed to R0–R2 based on complexity.
|
|
519
514
|
|
|
520
515
|
### Requirement Evaluation
|
|
521
516
|
|
|
522
|
-
Before R2
|
|
517
|
+
Before R2 tasks enter execution, the system scores requirements on four dimensions (scope 0–3, deliverable spec 0–3, implementation conditions 0–2, acceptance criteria 0–2). The pass condition is based on core dimension sufficiency (scope ≥ 3, implementation conditions ≥ 1, deliverable spec ≥ 1) rather than a fixed total score threshold. Dimensions below the sufficiency line trigger clarifying questions:
|
|
523
518
|
|
|
524
|
-
- `EVAL_MODE=1` (default, progressive): asks 1
|
|
525
|
-
- `EVAL_MODE=2` (one-shot): asks all
|
|
519
|
+
- `EVAL_MODE=1` (default, progressive): asks 1 insufficient dimension per round, up to 4 rounds
|
|
520
|
+
- `EVAL_MODE=2` (one-shot): asks all insufficient dimensions at once, up to 2 rounds
|
|
526
521
|
|
|
527
|
-
Context inferred from the existing codebase counts toward the score automatically. Say "skip evaluation / just do it" to bypass the questioning phase.
|
|
522
|
+
The last round of questioning is combined with confirmation (question + execution mode selection), reducing standalone confirmation steps. Context inferred from the existing codebase counts toward the score automatically. Say "skip evaluation / just do it" to bypass the questioning phase.
|
|
528
523
|
|
|
529
524
|
### Parallel Design Proposals
|
|
530
525
|
|
|
531
|
-
In the
|
|
526
|
+
In the R2 standard path, the design stage dispatches 3–6 sub-agents to independently generate competing implementation proposals. The main agent evaluates all proposals across four dimensions: user value, solution soundness, risk (including EHRB), and implementation cost. Weights are dynamically adjusted based on project characteristics (e.g., performance-critical systems weight soundness higher; MVPs weight cost higher).
|
|
532
527
|
|
|
533
528
|
- Interactive mode: user selects a proposal or requests re-generation (max 1 retry)
|
|
534
529
|
- Delegated mode: recommended proposal is auto-selected
|
|
535
|
-
- R2
|
|
530
|
+
- R2 standard path: complex tasks go through multi-proposal comparison; simple tasks skip it and go directly to planning
|
|
536
531
|
|
|
537
532
|
### Auto Dependency Management
|
|
538
533
|
|
|
@@ -554,15 +549,6 @@ During development, the system auto-detects the project's package manager via lo
|
|
|
554
549
|
4. Systemic scan — same issue in other modules?
|
|
555
550
|
5. Lessons learned recorded in the acceptance report
|
|
556
551
|
|
|
557
|
-
### Custom Command Extension
|
|
558
|
-
|
|
559
|
-
Create `.helloagents/commands/` in your project and drop in Markdown files — the filename becomes the command name:
|
|
560
|
-
|
|
561
|
-
.helloagents/commands/deploy.md → ~deploy
|
|
562
|
-
.helloagents/commands/release.md → ~release
|
|
563
|
-
|
|
564
|
-
File content defines the execution rules. The system applies a lightweight gate (requirement understanding + EHRB check).
|
|
565
|
-
|
|
566
552
|
### Smart Commit (~commit)
|
|
567
553
|
|
|
568
554
|
`~commit` does more than generate a message:
|
|
@@ -609,7 +595,7 @@ Tasks are stored in `{KB_ROOT}/tasks/` with file locking to prevent concurrent c
|
|
|
609
595
|
The knowledge base syncs automatically at these points:
|
|
610
596
|
|
|
611
597
|
- After every development stage, main agent syncs module docs to reflect actual code
|
|
612
|
-
- After every R1/R2
|
|
598
|
+
- After every R1/R2 task completion, CHANGELOG is auto-appended
|
|
613
599
|
- On session end (Claude Code Stop Hook), KB sync flag set asynchronously
|
|
614
600
|
|
|
615
601
|
CHANGELOG uses semantic versioning (X.Y.Z). Version source priority: user-specified → project file (package.json, pyproject.toml, etc., supporting 15+ languages/frameworks) → git tag → last CHANGELOG entry → 0.1.0. R1 fast-path changes are recorded under a "Quick Modifications" category with file:line range.
|
|
@@ -638,7 +624,7 @@ On the first response of each session, the system silently checks for new versio
|
|
|
638
624
|
|
|
639
625
|
- AGENTS.md: router and workflow protocol
|
|
640
626
|
- SKILL.md: skill discovery metadata for CLI targets
|
|
641
|
-
- pyproject.toml: package metadata (v2.3.
|
|
627
|
+
- pyproject.toml: package metadata (v2.3.8)
|
|
642
628
|
- helloagents/cli.py: CLI entry point
|
|
643
629
|
- helloagents/_common.py: shared constants and utilities
|
|
644
630
|
- helloagents/core/: CLI management modules (install, uninstall, update, status, dispatcher, hooks settings)
|
|
@@ -650,7 +636,6 @@ On the first response of each session, the system silently checks for new versio
|
|
|
650
636
|
- helloagents/hooks: Claude Code, Codex CLI, Gemini CLI, and Grok CLI hooks configs
|
|
651
637
|
- helloagents/scripts: automation scripts (sound notify, progress snapshot, safety guard, etc.)
|
|
652
638
|
- helloagents/agents: sub-agent definitions (3 RLM roles)
|
|
653
|
-
- helloagents/user/commands: custom command templates
|
|
654
639
|
- helloagents/assets: sound resources (5 event sounds)
|
|
655
640
|
- helloagents/templates: KB and plan templates
|
|
656
641
|
|
|
@@ -674,15 +659,15 @@ A: Role Language Model — HelloAGENTS's sub-agent orchestration system. It incl
|
|
|
674
659
|
|
|
675
660
|
**Q: Where does project knowledge go?**
|
|
676
661
|
|
|
677
|
-
A: In the project-local `.helloagents/` directory. The knowledge base auto-syncs when code changes (controlled by `KB_CREATE_MODE` config). It includes module docs
|
|
662
|
+
A: In the project-local `.helloagents/` directory. The knowledge base auto-syncs when code changes (controlled by `KB_CREATE_MODE` config). It includes module docs and CHANGELOG. See [KB Auto-Sync & CHANGELOG](#kb-auto-sync--changelog).
|
|
678
663
|
|
|
679
|
-
**Q: Does
|
|
664
|
+
**Q: Does knowledge persist across sessions?**
|
|
680
665
|
|
|
681
|
-
A: Yes
|
|
666
|
+
A: Yes. The project knowledge base is stored in the project-local `.helloagents/` directory. Context survives even if you close and reopen your CLI.
|
|
682
667
|
|
|
683
668
|
**Q: What are Hooks?**
|
|
684
669
|
|
|
685
|
-
A: Lifecycle hooks auto-deployed during installation. Claude Code gets 11 event hooks (safety checks, dangerous command guard, progress snapshots, KB sync, sound notifications, tool failure recovery, etc.); Codex CLI gets a notify hook for update and sound notifications; Gemini CLI
|
|
670
|
+
A: Lifecycle hooks auto-deployed during installation. Claude Code gets 11 event hooks (safety checks, dangerous command guard, progress snapshots, KB sync, sound notifications, tool failure recovery, etc.); Codex CLI gets a notify hook for update and sound notifications; Gemini CLI gets 6 hooks (context injection, progress snapshots, sound notifications, pre-compression snapshots); Grok CLI gets 3 hooks (context injection, safety guard, progress snapshots). All optional — features degrade gracefully when hooks aren't available. No manual configuration needed.
|
|
686
671
|
|
|
687
672
|
**Q: What is Agent Teams?**
|
|
688
673
|
|
|
@@ -738,7 +723,7 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
738
723
|
|
|
739
724
|
**Diagnosis:** Installation replaces existing files
|
|
740
725
|
|
|
741
|
-
**Solution:** Restore from timestamped backup in CLI config directory (e.g., `~/.codex/
|
|
726
|
+
**Solution:** Restore from timestamped backup in CLI config directory (e.g., `~/.codex/AGENTS_20260304132146_bak.md`)
|
|
742
727
|
|
|
743
728
|
**Verification:** Check backup files in config directory
|
|
744
729
|
|
|
@@ -788,7 +773,44 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
788
773
|
|
|
789
774
|
## Version History
|
|
790
775
|
|
|
791
|
-
### v2.3.
|
|
776
|
+
### v2.3.8 (current)
|
|
777
|
+
|
|
778
|
+
**Architecture Changes:**
|
|
779
|
+
- Routing tier consolidation: removed R2 simplified flow and R3 standard flow, unified to R0/R1/R2 three-tier routing. New R2 standard flow merges use cases from both old R2 and R3
|
|
780
|
+
- Evaluation now driven by dimension sufficiency (scope ≥ 3, implementation conditions ≥ 1, deliverable spec ≥ 1), replacing fixed total score threshold (previously "score ≥ 8")
|
|
781
|
+
- Last-round question+confirmation combined: clarifying question + execution mode selection in the same turn, reducing standalone confirmation steps
|
|
782
|
+
- DESIGN multi-proposal comparison now triggered by TASK_COMPLEXITY (complex → multi-proposal, simple/moderate → skip), replacing route-level triggering
|
|
783
|
+
- Removed L0 user memory system and custom command extension (`user/` directory): simplified to single-layer project knowledge model (L1 project KB only)
|
|
784
|
+
- Config system consolidation: migrated from two-tier priority config (`config.json` at project + global level) to single `~/.helloagents/helloagents.json` with auto-sync on install
|
|
785
|
+
- Added code size control rules: warning threshold (file/class 300 lines, function 40 lines), mandatory split threshold (file/class 400 lines, function 60 lines)
|
|
786
|
+
|
|
787
|
+
**New Features:**
|
|
788
|
+
- Added 5 new workflow commands: `~test`, `~rollback`, `~validatekb`, `~upgradekb`, `~cleanplan`
|
|
789
|
+
- Added notify_level config key (0=off, 1=desktop, 2=sound, 3=both) for notification behavior control
|
|
790
|
+
- Added standalone config reader module (`scripts/_config.py`) for hook scripts
|
|
791
|
+
- Brainstormer sub-agent output format enhanced: added `key_findings` field for proposal highlights
|
|
792
|
+
|
|
793
|
+
**Security:**
|
|
794
|
+
- Fixed path injection vulnerability in shared_tasks.py: `list_id` from environment variable now sanitized before use in file path construction
|
|
795
|
+
- Fixed incomplete path traversal guard in validate_package.py: `relative_to()` failure now properly exits with error instead of falling through
|
|
796
|
+
|
|
797
|
+
**Bug Fixes:**
|
|
798
|
+
- Fixed Gemini/Grok hooks PostToolUse matcher missing NotebookEdit (now `Write|Edit|NotebookEdit`, consistent with Claude Code)
|
|
799
|
+
- Fixed pre_compact.py still using deprecated LIVE_STATUS HTML comments while progress_snapshot.py had migrated to .status.json
|
|
800
|
+
- Fixed pre_compact.py `_get_current_task` regex only matching numbered lists, now supports unordered lists
|
|
801
|
+
- Fixed progress_snapshot.py docstring incorrectly stating Grok uses async=true (actual config is async=false)
|
|
802
|
+
- Fixed dispatcher update check cache_ttl default from None to 72 hours
|
|
803
|
+
- Fixed utils.py incorrectly treating Python package source directories as legacy KB directories during migration
|
|
804
|
+
- Fixed cli.py error recovery passing args as branch name when dispatcher is broken
|
|
805
|
+
|
|
806
|
+
**Improvements:**
|
|
807
|
+
- Codex CLI feature flags updated: replaced `sqlite`+`collaboration_modes` with `enable_fanout` for CSV batch orchestration
|
|
808
|
+
- Added Windows UTF-8 encoding block to codex_notify.py (all other hook scripts already had it)
|
|
809
|
+
- Extended stop_sound_router.py UTF-8 encoding to cover stdout/stderr (previously only stdin)
|
|
810
|
+
- Added NOTE comments across all intentionally duplicated functions for cross-file sync awareness
|
|
811
|
+
- Added yearly changelog archive template (`CHANGELOG_{YYYY}.md`)
|
|
812
|
+
|
|
813
|
+
### v2.3.7
|
|
792
814
|
|
|
793
815
|
**Bug Fixes:**
|
|
794
816
|
- Fixed non-coding tasks incorrectly creating knowledge base when KB_CREATE_MODE=2 (added programming task check in design.md Phase1 step 1)
|
|
@@ -812,7 +834,6 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
812
834
|
- Removed session memory features that couldn't be fully implemented in CLI (session_summary template, SessionEnd memory sync), streamlined service layer
|
|
813
835
|
- Sub-agent consolidation: removed 3 redundant sub-agents (kb-keeper, pkg-keeper, synthesizer), functionality returned to main agent and RLM roles
|
|
814
836
|
- Sub-agent voice notification skip, task stability fixes
|
|
815
|
-
- Unified user config directory structure (user/memory/, user/commands/, user/sounds/)
|
|
816
837
|
- Uninstall script enhancements
|
|
817
838
|
- Visual verification gap and UI quality fixes
|
|
818
839
|
|
|
@@ -821,12 +842,11 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
821
842
|
**New Features:**
|
|
822
843
|
- Voice notification system with 5 event sounds (complete, idle, confirm, error, warning) across Windows/macOS/Linux, with smart two-layer routing (stop_reason + G3 format icon detection)
|
|
823
844
|
- Claude Code hooks expanded from 9 to 11 lifecycle event types: added dangerous command guard (PreToolUse), session end cleanup (SessionEnd), and tool failure recovery suggestions (PostToolUseFailure)
|
|
824
|
-
- Hooks support expanded to Gemini CLI
|
|
825
|
-
- Codex CLI 0.110 features: `
|
|
845
|
+
- Hooks support expanded to Gemini CLI (SessionStart, BeforeAgent/AfterAgent, PreCompress, PreToolUse, PostToolUse) and Grok CLI (UserPromptSubmit, PreToolUse, PostToolUse)
|
|
846
|
+
- Codex CLI 0.110 features: `enable_fanout` for CSV batch orchestration, `nickname_candidates` for agent role identification
|
|
826
847
|
- Configuration integrity check on session start (auto-detect config corruption or replacement by CCswitch etc.)
|
|
827
848
|
- Context compression pre-save with automatic progress snapshot (pre_compact.py, progress_snapshot.py — actual implementations replacing placeholder hooks)
|
|
828
849
|
- User-defined tool registration and orchestration — intelligent invocation of custom sub-agents, skills, MCP servers, and plugins
|
|
829
|
-
- Custom command extension support via `.helloagents/commands/*.md`
|
|
830
850
|
|
|
831
851
|
**Improvements:**
|
|
832
852
|
- Comprehensive audit fixes (21 issues: 6 HIGH + 9 MEDIUM + 6 LOW)
|
|
@@ -839,7 +859,7 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
839
859
|
- Voice notification accuracy and false positive reduction (Codex client filtering, Windows sync playback)
|
|
840
860
|
- Sub-agent nickname optimization across CLIs
|
|
841
861
|
- Codex CLI interactive menu, persistent memory, and context compression optimization
|
|
842
|
-
- R2
|
|
862
|
+
- R2 flow and evaluation module re-integration
|
|
843
863
|
- Context compression state persistence optimization
|
|
844
864
|
- Tool/Shell usage optimization
|
|
845
865
|
- CCswitch compatibility notes for configuration cleanup after uninstall
|
|
@@ -862,7 +882,6 @@ A: An experimental Claude Code feature where multiple Claude Code instances coll
|
|
|
862
882
|
- Auto-inject project technical guidelines before sub-agent development
|
|
863
883
|
- Pre-commit quality checks (code-doc consistency, test coverage, verification commands)
|
|
864
884
|
- Worktree isolation for parallel editing
|
|
865
|
-
- Custom command extension (.helloagents/commands/)
|
|
866
885
|
- Auto-append Git author info to CHANGELOG entries
|
|
867
886
|
|
|
868
887
|
## Contributing
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "helloagents",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.8",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "HelloAGENTS - AI-native sub-agent orchestration framework for multi-CLI environments",
|
|
6
6
|
"author": "HelloWind",
|
|
@@ -16,18 +16,7 @@
|
|
|
16
16
|
"files": [
|
|
17
17
|
"bin/"
|
|
18
18
|
],
|
|
19
|
-
"keywords": [
|
|
20
|
-
"ai",
|
|
21
|
-
"agent",
|
|
22
|
-
"claude",
|
|
23
|
-
"codex",
|
|
24
|
-
"gemini",
|
|
25
|
-
"qwen",
|
|
26
|
-
"grok",
|
|
27
|
-
"opencode",
|
|
28
|
-
"cli",
|
|
29
|
-
"workflow"
|
|
30
|
-
],
|
|
19
|
+
"keywords": ["ai", "agent", "claude", "codex", "gemini", "qwen", "grok", "opencode", "cli", "workflow"],
|
|
31
20
|
"engines": {
|
|
32
21
|
"node": ">=16"
|
|
33
22
|
}
|