- Go matching the version in
go.mod - Node.js and pnpm 11.1.3
Use the Go start mode for normal local use:
go run . -startStart mode installs frontend dependencies when needed, rebuilds the UI when built assets are missing or stale, starts AgentMeter, and opens:
http://127.0.0.1:34115
go run . -start serves built frontend assets through the Go server. It is not
the Vite hot module reload workflow.
On first launch, click Update Index in the app. AgentMeter defaults to
detected local agent homes such as ~/.codex and ~/.claude. In Settings,
enter one source root per line when you use multiple agents, keep session logs
elsewhere, or run more than one instance of the same agent family.
Each configured root is a source instance. The agent family, such as codex or
claude, controls parsing and family-level filters; the source instance keeps a
separate source label, root path, and sessions path so multiple Codex or Claude
installations stay distinguishable. Add a manual source label when the path
alone is not clear, for example Work Codex or Personal Claude.
Update Index skips unchanged JSONL files; Rebuild Index clears indexed files for enabled sources and parses every JSONL file again.
The default database path follows the host OS:
Windows: %LOCALAPPDATA%\AgentMeter\agentmeter.sqlite
macOS: ~/Library/Application Support/AgentMeter/agentmeter.sqlite
Linux: $XDG_DATA_HOME/AgentMeter/agentmeter.sqlite or ~/.local/share/AgentMeter/agentmeter.sqlite
Default source roots are detected from local agent homes when they exist:
~/.codex
~/.claude
~/.codebuddy
~/.workbuddy
AgentMeter also classifies configured variants with known agent structure, such
as alternate Codex roots containing sessions or archived_sessions, Claude
roots containing projects, and CodeBuddy/WorkBuddy roots containing
projects or sessions. Startup can add newly detected default homes while the
source list is still auto-managed; once you save Settings, manually removed
sources stay removed.
Build the frontend and start local HTTP mode manually:
cd frontend
pnpm install --frozen-lockfile
pnpm run build
cd ..
go run . -ui web -http 127.0.0.1:34115Open:
http://127.0.0.1:34115
You can also pass a built asset directory explicitly:
go run . -ui web -static frontend/distFor frontend development with Vite hot module reload, run the backend and frontend dev server in separate terminals.
Backend:
go run . -http 127.0.0.1:34115Frontend:
cd frontend
pnpm run devOpen:
http://127.0.0.1:5173
Vite proxies /api requests to the Go backend.
For Go backend auto-restart, run Air through the Go tool directive:
go tool air -c .air.tomlStart the terminal UI with:
go run . -ui tuiFor mode behavior, command flags, and TUI keyboard bindings, see UI Modes.
The TUI uses the same source identity as Web mode. Overview top agents show source labels with family/path context, session rows use the source label or agent name, and Session Detail includes the source root and raw JSONL file path.
AgentMeter can inspect and edit supported user-level privacy config files without opening the Web UI:
go run . privacy status
go run . privacy settings codex
go run . privacy apply codex
go run . privacy apply all recommended
go run . privacy apply gemini strictprivacy apply <target> defaults to the recommended profile. Use strict to
write every managed hardening setting, or default to unset AgentMeter-managed
keys and return to vendor defaults. Supported targets are codex, gemini,
claude, and codebuddy. Existing config files are backed up before writes.
The CLI applies privacy profiles by target. In the Web UI, privacy writes can
also be scoped to a selected indexed source for supported targets, so users with
multiple local homes can choose which root's config.toml or settings.json
to edit.
The complete validation and smoke contract lives in Validation. Common commands:
go test ./...cd frontend
pnpm install --frozen-lockfile
pnpm run build
cd ..powershell -NoProfile -ExecutionPolicy Bypass -File scripts/smoke-api.ps1 -BaseUrl http://127.0.0.1:34115cd frontend
pnpm run test:smoke
cd ..Routine smoke checks should be read-only unless the task explicitly asks to validate indexing, settings writes, or privacy config changes.