nousresearch / hermes-agent
pythonmain2ecb6f71.3M linessynced 1mo ago
Code health
6.5out of 10Good
This codebase scores 6.5 out of 10 on defect risk, which we rate good. It also scores maintainability 7.6 and static performance risk 9.8 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 683 of 5,318 files are git hotspots, and they average 4.4.
- Lines of code
- 1.3M
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- "Account: Serene Temple (created)" / "Account: example-name (reused)" Account names can contain spacproposed
- "New chat" prefers ChatPage's robust handler (clears resume + forces a PTY respawn even from an alreproposed
- "You are obligated to" appears in legal / policy / spec writing. We do NOT have a standalone "obligaproposed
- "billing:manage-lite" must NOT match billing:manage (split-based, not substring).proposed
- "branch investigate" at cols=20 fits on one row in wrap-ansi. The bug claimed otherwise, parking theproposed
- "every" is not in the alternation, but "prior" is — the regex should still match because "prior" appproposed
Needs attention
1,643 open- high severity. Stale decisionExclude matrix extra from [all] to avoid non-lazy build failures on Windows/macOSActive decision drifting from the code it governs
- high severity. Stale decisionMemoize KaTeX rendering in rehype-katex wrapperActive decision drifting from the code it governs
- high severity. Stale decisionPin direct dependencies exactly to control transitive updatesActive decision drifting from the code it governs
- high severity. Stale decisionPrevent local backend respawn during in-app updateActive decision drifting from the code it governs
- medium severity. Proposed"Account: Serene Temple (created)" / "Account: example-name (reused)" Account names can contain spacAuto-proposed decision awaiting review
Where the risk concentrates
All 683 hotspotsRanked by prior bug fixes and change frequency, mined from full git history rather than from the code alone.
| File | Churn | Prior fixes | Maintainers | Commits 90d |
|---|---|---|---|---|
| app.tsxui-tui/src | 100.0th | 0 | 4bus factor 1 | 78 |
| web_tools.pytools | 99.9th | 0 | 28 | 47 |
| test_mcp_tool.pytests/tools | 99.9th | 0 | 13 | 23 |
| server.pytui_gateway | 99.9th | 0 | 17 | 44 |
| App.tsxweb/src | 99.9th | 0 | 10 | 45 |
Composition
Open the graphpython 49%typescript 20%markdown 19%external 5%yaml 3%Other 4%
Explore this codebase
- Docs508 pages across 232 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files5,318 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 133 entry points
- Code healthPer-file scores, 24,472 open findings, coverage and refactoring targets
- Knowledge graphEntities, communities, and the paths between them
- Change couplingFiles that keep changing together, mined from commit history
- CommitsChange-risk ranked history with agent provenance
- ContributorsBus factor, per-file maintainers, and the human/agent split
- StatsSize class, origin, lifetime churn, rhythm and records
- CostsWhat indexing this snapshot cost, by model and by run