# NousResearch/hermes-agent · CLI credit balance and usage tracking features

## Open now

- 0 issues, 1 PR open on GitHub.
- PR #77791: feat: add Portal usage JSON command

These issues and pull requests concern adding CLI commands and API endpoints to view Nous Portal credit balances, account usage, and related billing information. They include in-session usage notices, a /usage command, a /credits command, and a portal top-up handoff.

## TL;DR

- 4 member(s): 0 open issue(s), 2 closed issue(s), 1 open PR(s), 0 merged PR(s), 1 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.39`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #24814: Feature Request: Nous Portal credit balance API endpoint for CLI usage monitoring
- #33376: Feature Request: Check Nous Portal credit balance and usage via CLI

## Prior & competing PRs

- **#33888: feat: add Nous Portal account usage tracking (#33376)**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `fcb1944b4f76cc74d5092c2b8605d972c095bd3c`
- **#77791: feat: add Portal usage JSON command**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `agent/insights.py`, `hermes_cli/config_defaults.py`, `hermes_cli/console_engine.py`, `hermes_cli/main.py`, `hermes_cli/portal_cli.py`, `hermes_cli/subcommands/insights.py`, `tests/agent/test_insights.py`, `tests/hermes_cli/test_portal_usage_cli.py`, `ui-tui/src/__tests__/markdown.test.ts`, `ui-tui/src/app/interfaces.ts`, `ui-tui/src/app/uiStore.ts`, `ui-tui/src/app/useConfigSync.ts`, `ui-tui/src/components/markdown.tsx`, `ui-tui/src/gatewayTypes.ts`, `website/docs/integrations/nous-portal.md`

## Fix status

- No merged fix on record.
- Subsystem: `agent`