Skip to content

Restructure README#34

Merged
anilmurty merged 9 commits into
mainfrom
readme-updates
Apr 15, 2026
Merged

Restructure README#34
anilmurty merged 9 commits into
mainfrom
readme-updates

Conversation

@anilmurty
Copy link
Copy Markdown
Contributor

@anilmurty anilmurty commented Apr 15, 2026

Summary

Restructure the README by moving detailed sections into dedicated docs under docs/ and verify all docs against the current codebase.

README changes

  • Removed "Works with Claude Code out of the box" from The Problem section
  • Removed "Why not LangSmith / Langfuse / Datadog" comparison table
  • Removed inline Architecture mermaid diagram (moved to docs/architecture.md)
  • Added "Works out of the box with Claude Code, OpenClaw, NemoClaw and more" to features list
  • Replaced inline sections with one-line summaries + hyperlinks: Claude Code, NemoClaw, Framework Support, Alerts, Export, Configuration, CLI Reference, Examples, Roadmap, Architecture
  • Removed Contributing section (already covered by CONTRIBUTING.md)

New docs

  • docs/claude-code-integration.md — full setup, MCP server, multi-project, uninstall
  • docs/nemoclaw-integration.md — sandbox event observability, alert types, config
  • docs/framework-support.md — provider patches, framework patches, zero-code OTLP, TypeScript SDK
  • docs/alerts.md — 13 alert types, 6 channels, cooldown, content stripping
  • docs/export.md — JSON/CSV/OTLP/OpenEvals formats, Prometheus, REST API
  • docs/configuration.md — full TOML reference with all sections
  • docs/cli-reference.md — all 15 commands with flags and examples
  • docs/examples.md — full example list with env vars and setup
  • docs/roadmap.md — completed and planned features

Docs verified and fixed against codebase

  • docs/architecture.md — fixed /v1/logs (not a stub), added Budget as 6th web UI view, added auto-polling, fixed --claude-code config path, added MCP registration to onboard flow, added full REST API route inventory, updated diagram to show all 3 ingest paths + MCP/Web UI consumers
  • docs/cli-reference.md — fixed --group-by (was --by), added missing flags (--budget, --force, --unread, --host, --port, --reload)
  • docs/alerts.md — added missing session_duration alert type
  • docs/configuration.md — fixed export.otlp.protocol default
  • CONTRIBUTING.md — added [mcp] extra to install command

Other

Test plan

  • Verify all doc hyperlinks resolve correctly on GitHub
  • Verify mermaid diagram renders in docs/architecture.md
  • pytest tests/unit/ tests/synthetic/ tests/agents/ tests/integration/

🤖 Generated with Claude Code

anilmurty and others added 9 commits April 15, 2026 08:34
README:
- Remove "Works with Claude Code" from The Problem section
- Remove "Why not LangSmith / Langfuse / Datadog" section
- Remove inline Architecture mermaid diagram (moved to docs/)
- Replace inline Claude Code, NemoClaw, OpenClaw, and framework
  details with hyperlinks to dedicated docs
- Slim framework support to a summary table linking to docs/

New docs:
- docs/claude-code-integration.md — full Claude Code setup, MCP, uninstall
- docs/nemoclaw-integration.md — NemoClaw sandbox event observability
- docs/framework-support.md — provider patches, framework patches, OTLP, TS SDK

Updated docs:
- docs/architecture.md — replace ASCII diagram with mermaid flowchart from README

Also:
- pyproject.toml: 0.1.7 → 0.1.8
- sdk-ts/package.json: 0.1.7 → 0.1.8
- CLAUDE.md: add critical rule #14 (version bump on release)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The Contributing tab (CONTRIBUTING.md) already covers setup, tests,
PR guidelines, and Claude Code workflow. Added [mcp] extra to the
install command there. Removed the redundant section from README.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…docs

New docs:
- docs/alerts.md — 13 alert types, 6 channels, cooldown, content stripping
- docs/export.md — JSON/CSV/OTLP/OpenEvals formats, Prometheus, REST API
- docs/configuration.md — full TOML reference with all sections explained
- docs/cli-reference.md — all 15 commands with flags and examples

README sections replaced with one-line summaries + hyperlinks.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
New docs:
- docs/examples.md — full example list with env vars, deps, and setup notes
- docs/roadmap.md — completed and planned features

Updated:
- README: replace Framework Support table, Examples list, and Roadmap
  checklist with one-line summaries + hyperlinks

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix /v1/logs: not a stub, it's the Claude Code log-to-span converter
- Fix Web UI: six views not five (Budget was missing)
- Add auto-polling intervals (Status 5s, all others 10s)
- Fix onboard --claude-code: writes to ~/.config/ocw/config.toml (global),
  not .ocw/config.toml
- Add MCP registration and daemon --config flag to onboard flow
- Add full REST API route inventory table (includes /agents, /budget,
  /alerts/{id}/acknowledge that were undocumented)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
cli-reference.md:
- Add missing --budget and --force flags to ocw onboard
- Fix ocw cost: flag is --group-by, not --by
- Add missing --unread flag to ocw alerts
- Add --host, --port, --reload flags to ocw serve

alerts.md:
- Add missing session_duration alert type (13th of 13)

configuration.md:
- Fix export.otlp.protocol default from "http/protobuf" to "http"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add Claude Code → POST /v1/logs as the third ingest path with
log-to-span conversion label. Add Web UI and MCP Server as DB
consumers (were missing). Update description to match.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@anilmurty anilmurty changed the title Restructure README and bump version to 0.1.8 Restructure README Apr 15, 2026
@anilmurty anilmurty requested a review from anshss April 15, 2026 16:29
@anilmurty anilmurty merged commit 106f074 into main Apr 15, 2026
4 checks passed
@anilmurty anilmurty deleted the readme-updates branch April 15, 2026 16:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant