agenthud 0.7.3 → 0.8.0

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.
Files changed (6) hide show
  1. package/README.md +93 -146
  2. package/dist/index.js +1 -1
  3. package/dist/main-CA4K47Y5.js +1682 -0
  4. package/dist/templates/config.yaml +1 -1
  5. package/package.json +1 -1
  6. package/dist/main-4ACNXJYW.js +0 -4166
package/README.md CHANGED
@@ -4,15 +4,13 @@
4
4
  [![CI](https://github.com/neochoon/agenthud/actions/workflows/ci.yml/badge.svg)](https://github.com/neochoon/agenthud/actions/workflows/ci.yml)
5
5
  [![codecov](https://codecov.io/gh/neochoon/agenthud/branch/main/graph/badge.svg)](https://codecov.io/gh/neochoon/agenthud)
6
6
 
7
- When working with AI coding agents like Claude Code, you lose visibility into what's happening. The agent reads files, runs commands, makes changes - but you're staring at a single terminal, waiting.
8
-
9
- **AgentHUD** gives you a live dashboard in a separate terminal. See exactly what Claude is doing, track git changes, monitor test results - all updating in real-time.
7
+ When working with AI coding agents like Claude Code, you lose visibility into what's happening across sessions. **AgentHUD** gives you a live session browser in a separate terminal — see every session, sub-agent, and activity as it happens.
10
8
 
11
9
  ![demo](./output960.gif)
12
10
 
13
11
  ## Install
14
12
 
15
- Requires Node.js 20+. Tested on Ubuntu, Windows, macOS.
13
+ Requires Node.js 20+.
16
14
 
17
15
  ```bash
18
16
  npx agenthud
@@ -20,159 +18,108 @@ npx agenthud
20
18
 
21
19
  Run this in a separate terminal while using Claude Code.
22
20
 
23
- ## Why?
24
-
25
- - **See what the agent is doing** - Watch file reads, edits, bash commands as they happen
26
- - **Track your git state** - Commits, branches, uncommitted changes at a glance
27
- - **Know if tests pass** - Results update automatically, shows if outdated
28
- - **Stay oriented** - Project info, dependencies, file counts
29
- - **Monitor other sessions** - See what's happening in your other Claude Code projects
21
+ ## What it shows
30
22
 
31
- ## Usage
23
+ AgentHUD reads Claude Code's session files from `~/.claude/projects/` and displays them in a split view:
32
24
 
33
25
  ```
34
- agenthud [command] [options]
35
-
36
- Commands:
37
- init Create config file in current directory
38
-
39
- Options:
40
- -w, --watch Watch mode (default)
41
- --once Run once and exit
42
- -V, --version Show version
43
- -h, --help Show help
26
+ ┌─ Sessions ──────────────────────────────────────────────┐
27
+ │ > agenthud │
28
+ │ sub-agent: code-reviewer │
29
+ │ myproject │
30
+ │ dotfiles │
31
+ └─────────────────────────────────────────────────────────┘
32
+ ┌─ Activity · agenthud ───────────────────────────────────┐
33
+ │ [10:23:45] ○ Read src/ui/App.tsx │
34
+ │ [10:23:46] ~ Edit src/ui/App.tsx │
35
+ │ [10:23:47] $ Bash npm test │
36
+ │ [10:23:50] < Response Tests passed successfully │
37
+ │ [10:23:51] … Thinking Analyzing the test results... │
38
+ └─────────────────────────────────────────────────────────┘
44
39
  ```
45
40
 
41
+ **Session tree (top pane)**
42
+ - All Claude Code sessions across all projects
43
+ - Sub-agents shown nested under their parent session
44
+ - Live indicator on currently active session
45
+
46
+ **Activity viewer (bottom pane)**
47
+ - Real-time activity feed for the selected session
48
+ - File reads, edits, bash commands, responses, thinking blocks
49
+ - Automatically tails the live session; press `g` to scroll back to top
50
+
51
+ ## Activity types
52
+
53
+ | Icon | Type | Description |
54
+ |------|------|-------------|
55
+ | `○` | Read | File being read |
56
+ | `~` | Edit / Write | File being modified |
57
+ | `$` | Bash | Shell command |
58
+ | `*` | Glob / Grep | File search |
59
+ | `@` | WebFetch / WebSearch | Web request |
60
+ | `»` | Task | Sub-agent task |
61
+ | `<` | Response | Claude's text response |
62
+ | `>` | User | Your message |
63
+ | `…` | Thinking | Claude's thinking (requires `showThinkingSummaries: true`) |
64
+
65
+ ## Keyboard shortcuts
66
+
67
+ ### Session tree focus
68
+
69
+ | Key | Action |
70
+ |-----|--------|
71
+ | `↑` / `k` | Select previous session |
72
+ | `↓` / `j` | Select next session |
73
+ | `↵` | Expand / collapse sub-agents |
74
+ | `h` | Hide session or sub-agent |
75
+ | `Tab` | Switch to activity viewer |
76
+ | `PgUp` / `Ctrl+B` | Page up |
77
+ | `PgDn` / `Ctrl+F` | Page down |
78
+ | `r` | Refresh |
79
+ | `q` | Quit |
80
+
81
+ ### Activity viewer focus
82
+
83
+ | Key | Action |
84
+ |-----|--------|
85
+ | `↑` / `k` | Scroll up |
86
+ | `↓` / `j` | Scroll down |
87
+ | `g` | Jump to top |
88
+ | `G` | Jump to bottom (live) |
89
+ | `↵` | Open detail view |
90
+ | `s` | Save log to `~/.agenthud/logs/` |
91
+ | `Tab` | Switch to session tree |
92
+ | `PgUp` / `Ctrl+B` | Page up |
93
+ | `PgDn` / `Ctrl+F` | Page down |
94
+ | `Ctrl+U` | Half page up |
95
+ | `Ctrl+D` | Half page down |
96
+ | `q` | Quit |
97
+
98
+ ### Detail view (full content)
99
+
100
+ Press `↵` on any activity to open a scrollable full-content view.
101
+
102
+ | Key | Action |
103
+ |-----|--------|
104
+ | `↑` / `k` | Scroll up |
105
+ | `↓` / `j` | Scroll down |
106
+ | `↵` / `Esc` / `q` | Close |
107
+
46
108
  ## Configuration
47
109
 
48
- Optional. Create `.agenthud.yaml` to customize:
110
+ Optional. Create `~/.agenthud/config.yaml`:
49
111
 
50
112
  ```yaml
51
- panels:
52
- claude:
53
- enabled: true
54
- interval: 5s
55
- max_activities: 20
56
- git:
57
- enabled: true
58
- interval: 30s
59
- tests:
60
- enabled: true
61
- interval: manual # press 't' to run
62
- project:
63
- enabled: true
64
- interval: 60s
65
- other_sessions:
66
- enabled: true
67
- interval: 10s
68
- ```
69
-
70
- ## Panels
71
-
72
- ### Claude Panel
73
-
74
- Shows real-time Claude Code activity:
75
-
76
- ```
77
- ┌─ Claude ─────────────────────────────────────────────┐
78
- │ [10:23:45] ○ Read: src/components/Button.tsx │
79
- │ [10:23:46] ~ Edit: src/components/Button.tsx │
80
- │ [10:23:47] $ Bash: npm test │
81
- │ [10:23:50] < Response: Tests passed successfully... │
82
- └──────────────────────────────────────────────────────┘
113
+ refreshInterval: 2s # How often to poll for updates (default: 2s)
114
+ logDir: ~/.agenthud/logs # Where to save logs with 's' key
115
+
116
+ # Sessions/sub-agents to hide from the tree
117
+ hiddenSessions:
118
+ - old-project
119
+ hiddenSubAgents:
120
+ - code-reviewer
83
121
  ```
84
122
 
85
- - **○ Read**: File being read
86
- - **~ Edit/Write**: File being modified
87
- - **$ Bash**: Command being executed
88
- - **< Response**: Claude's text response
89
-
90
- ### Git Panel
91
-
92
- Shows today's git activity and current state:
93
-
94
- ```
95
- ┌─ Git ────────────────────────────────────────────────┐
96
- │ feat/add-dashboard · +142 -23 · 3 commits · 5 files │
97
- │ • abc1234 Add dashboard component │
98
- │ • def5678 Fix styling issues │
99
- └──────────────────────────────────────────────────────┘
100
- ```
101
-
102
- - **Branch name**: Current working branch (green)
103
- - **Stats**: Lines added/deleted, commits, files changed
104
- - **dirty**: Shows uncommitted change count (yellow)
105
-
106
- ### Tests Panel
107
-
108
- Shows test results with staleness detection:
109
-
110
- ```
111
- ┌─ Tests ──────────────────────────────────────────────┐
112
- │ ✓ 42 passed ✗ 1 failed ○ 2 skipped · abc1234 │
113
- │ ⚠ Outdated (3 commits behind) │
114
- │──────────────────────────────────────────────────────│
115
- │ ✗ Button.test.tsx │
116
- │ • should render correctly │
117
- └──────────────────────────────────────────────────────┘
118
- ```
119
-
120
- - **✓ passed** (green), **✗ failed** (red), **○ skipped**
121
- - **⚠ Outdated**: Warning if tests are behind commits
122
- - **Failures**: Shows failing test file and name
123
-
124
- **Auto-detection**: During `agenthud init`, the test framework is automatically detected:
125
-
126
- | Framework | Detection |
127
- |-----------|-----------|
128
- | vitest | package.json devDependencies |
129
- | jest | package.json devDependencies |
130
- | mocha | package.json devDependencies |
131
- | pytest | pytest.ini, conftest.py, pyproject.toml, requirements.txt |
132
-
133
- If the test command fails, the panel is automatically disabled.
134
-
135
- ### Project Panel
136
-
137
- Shows project overview and structure:
138
-
139
- ```
140
- ┌─ Project ────────────────────────────────────────────┐
141
- │ agenthud · TypeScript · MIT │
142
- │ Stack: react, ink, vitest │
143
- │ Files: 45 .ts · Lines: 3.2k │
144
- │ Deps: 12 prod · 8 dev │
145
- └──────────────────────────────────────────────────────┘
146
- ```
147
-
148
- - **Name/Language/License**: Project basics
149
- - **Stack**: Detected frameworks and tools
150
- - **Files/Lines**: Source code stats
151
- - **Deps**: Dependency counts
152
-
153
- ### Other Sessions Panel
154
-
155
- Shows activity from your other Claude Code projects:
156
-
157
- ```
158
- ┌─ Other Sessions ─────────────────────────────────────┐
159
- │ dotfiles, pain-radar, myapp +4 | * 1 active │
160
- │ │
161
- │ * dotfiles (2m ago) │
162
- │ "Updated the config file as requested..." │
163
- └──────────────────────────────────────────────────────┘
164
- ```
165
-
166
- - **Project names**: Shows up to 3 recent projects, +N for more
167
- - **Active indicator**: `*` active (within 5 min), `o` inactive
168
- - **Last message**: Most recent assistant response from that session
169
-
170
- ## Keyboard
171
-
172
- - `q` quit
173
- - `r` refresh all
174
- - `t` run tests (when manual)
175
-
176
123
  ## Feedback
177
124
 
178
125
  Issues and PRs welcome at [GitHub](https://github.com/neochoon/agenthud).
package/dist/index.js CHANGED
@@ -14,4 +14,4 @@ Error: Node.js ${MIN_NODE_VERSION}+ is required (current: ${process.version})
14
14
  console.error(" https://nodejs.org/\n");
15
15
  process.exit(1);
16
16
  }
17
- import("./main-4ACNXJYW.js").then(({ main }) => main());
17
+ import("./main-CA4K47Y5.js");