You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CLAUDE.md
+4-34Lines changed: 4 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
5
5
## Project Overview
6
6
7
-
NodePulse Agent v2.0 is a lightweight Prometheus forwarder written in Go that scrapes metrics from `node_exporter` and forwards them to a central dashboard via HTTP. The agent is designed to be minimal (<15 MB binary, <40 MB RAM) and efficient, with smart buffering for offline resilience using a Write-Ahead Log (WAL) pattern.
7
+
NodePulse Agent is a lightweight Prometheus forwarder written in Go that scrapes metrics from `node_exporter` and forwards them to a central dashboard via HTTP. The agent is designed to be minimal (<15 MB binary, <40 MB RAM) and efficient, with smart buffering for offline resilience using a Write-Ahead Log (WAL) pattern.
8
8
9
9
## Build & Development Commands
10
10
@@ -58,13 +58,13 @@ The agent uses [Cobra](https://github.com/spf13/cobra) for CLI command handling:
58
58
- Foreground mode (`pulse start`): Runs in terminal, blocks execution
59
59
- Daemon mode (`pulse start -d`): Spawns background process using `exec.Command` with `Setsid: true`
60
60
- Both modes create PID file EXCEPT when running under systemd (detected via `INVOCATION_ID` env var)
61
-
-**v2.0**: Scrapes Prometheus instead of collecting custom metrics
61
+
-**Current**: Scrapes Prometheus instead of collecting custom metrics
62
62
-**cmd/stop.go**: Stops daemon mode only (reads PID file, sends SIGTERM → SIGKILL if needed)
63
63
- Will NOT stop systemd-managed processes (they don't create PID files)
64
64
- Provides helpful message if systemd service is running
65
65
-**cmd/service.go**: systemd service management (install/start/stop/restart/status/uninstall)
66
66
-**cmd/setup.go**: Setup wizard for first-time configuration (command: `pulse setup`)
67
-
-**v2.0**: Interactive TUI mode removed, only quick mode (`--yes`) available
67
+
-**Current**: Interactive TUI mode removed, only quick mode (`--yes`) available
68
68
- Prompts for: endpoint URL and server_id
69
69
-**cmd/status.go**: Shows comprehensive agent status including server ID, config, service status, buffer state, and logs
70
70
-**cmd/update.go**: Self-update command that checks for new versions and performs updates
@@ -169,18 +169,6 @@ The agent runs as a **long-running daemon**:
169
169
170
170
**Key Design Point**: The agent scrapes Prometheus exporters and forwards the text format. It does NOT parse or interpret the metrics - it's a simple forwarder.
171
171
172
-
## Removed in v2.0
173
-
174
-
### TUI Dashboard (cmd/watch.go) - REMOVED
175
-
- ❌ No longer exists
176
-
- ❌ All Bubble Tea and Lipgloss dependencies removed
177
-
- Users should use the dashboard for visualization
0 commit comments