[Resource]: Observagent

[darshannere]

Display Name

Observagent

Category

Tooling

Sub-Category

Tooling: Usage Monitors

Primary Link

https://github.com/darshannere/observagent/

Author Name

Darshan Nere

Author Link

https://darshannere.com

License

Apache-2.0

Other License

No response

Description

Local-first observability for Claude Code sessions with zero-config hook setup. It captures tool calls and subagent lifecycle events in real time, tracks token and cost data from local Claude JSONL transcripts, and provides live and history dashboards for debugging latency, failures, and spend.

Validate Claims

Quick validation flow (about 5 minutes):

1. Install and start:

   • npm install -g @darshannere/observagent
   • observagent init
   • observagent start

2. Open http://localhost:4999.

3. In Claude Code, run the exact demo prompt from the “Specific Prompt(s)” field in this submission.
   (This generates the live tool events, error event, and subagent events ObservAgent is meant to show.)

4. Confirm on /live:

   • tool log updates live without refresh
   • rows include enriched summaries (command/path/pattern/task description)
   • failed Bash command is highlighted
   • subagent activity appears in the agent view/timeline

5. Confirm on /history:

   • sessions are listed
   • export works for JSONL and CSV

If npm registry install fails, install directly from GitHub source:

git clone https://github.com/darshannere/observagent.git
cd observagent
npm install
npm --prefix frontend install
npm --prefix frontend run build
npm link

Then run:

observagent init
observagent start

Runtime network behavior:

• ObservAgent does not require outbound external network calls.
• Server binds to 127.0.0.1.

Specific Task(s)

Run a short mixed-tool Claude Code workflow that includes:

• Bash, Read, Grep, Write, and Task (subagent) tool usage
• one intentionally failing Bash command
• one session export from the history page

Specific Prompt(s)

In this repository, do the following in order:

1. Run pwd and ls.
2. Read README.md.
3. Search for "Context" in README.md.
4. Create a file named observagent_demo.txt with 3 bullet points summarizing this project.
5. Run cat /tmp/this_file_does_not_exist to trigger one failed Bash command.
6. Spawn one subagent to summarize the Quick Start section of README.md in 5 bullets.
7. Delete observagent_demo.txt.
8. End with a short summary of what was done.

Additional Comments

Install:

• npm install -g @darshannere/observagent
• observagent init
• observagent start

Uninstall:

1. npm uninstall -g @darshannere/observagent
2. Remove ObservAgent hook commands from ~/.claude/settings.json (entries that call relay.py)
3. Remove ~/.claude/observagent/relay.py
4. Optional cleanup: remove local DB at ~/.local/share/observagent/observagent.db (or %APPDATA%/observagent/observagent.db on Windows)

Security and permissions:

• Does not require --dangerously-skip-permissions
• Local-only default bind (127.0.0.1)
• No telemetry pipeline

Recommendation Checklist

• I have checked that this resource hasn't already been submitted
• It has been over one week since the first public commit to the repo I am recommending
• All provided links are working and publicly accessible
• I do NOT have any other open issues in this repository
• I am primarily composed of human-y stuff and not electrical circuits

[hesreallyhim]

Thanks for the recommendation! This repository is less than a week old. We ask that projects have some time in the wild before being recommended — you're welcome to re-submit after March 7, 2026.

A cooldown of 7 days has been applied.

[github-actions]

🤖 Validation Results

✅ All validation checks passed!

Your submission is ready for review by a maintainer.

Validated Data:

{
  "display_name": "Observagent",
  "category": "Tooling",
  "subcategory": "Usage Monitors",
  "primary_link": "https://github.com/darshannere/observagent/",
  "author_name": "Darshan Nere",
  "author_link": "https://darshannere.com",
  "license": "Apache-2.0",
  "description": "Local-first observability for Claude Code sessions with zero-config hook setup. It captures tool calls and subagent lifecycle events in real time, tracks token and cost data from local Claude JSONL transcripts, and provides live and history dashboards for debugging latency, failures, and spend.",
  "secondary_link": "",
  "last_modified": "2026-03-08:19-06-12",
  "active": "TRUE",
  "last_checked": "2026-03-10:03-23-21"
}

---

_{This comment is automatically updated when you edit the issue.}