docs: add concise usage guide

[skulidropek]

Summary

• Replace long README with concise install/start/MCP usage guide
• Document Codex and Hermes config for browser-connection
• Keep smoke test and development commands

Test Plan

• cargo fmt --check
• cargo check --locked --bins
• cargo test --locked
• cargo clippy --locked --all-targets -- -D warnings

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 6cd45a65-a607-4325-8cd0-c70523f4be79

📥 Commits

Reviewing files that changed from the base of the PR and between 743ebcb and 24ede50.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Summary by CodeRabbit

• Documentation
  • Restructured README with simplified installation and setup instructions
  • Added smoke test section with example JSON-RPC tool invocation
  • Removed verbose sections on container lifecycle and formal guarantees
  • Condensed configuration guidance and development command references

Walkthrough

README.md was restructured and condensed to streamline user onboarding. Installation and MCP configuration sections were simplified; a new "Smoke test" section demonstrates JSON-RPC invocation; "Notes" document behavioral invariants. Verbose sections on container lifecycle, formal guarantees, and integration details were removed.

Changes

README restructure and condensing

Layer / File(s)	Summary
Installation and MCP configuration README.md (lines 1–63)	Installation instructions, browser startup flow, and Codex/Hermes MCP configuration snippets were rewritten for brevity and clarity, replacing longer guidance with a locked git install command and simplified tool configuration examples.
Smoke test, notes, and development README.md (lines 75–101)	Added a "Smoke test" section with a JSON-RPC example using --no-start-browser, followed by "Notes" describing container naming and Docker detection behavior. Removed detailed runtime diagrams and formal guarantees. Reduced the "Development" section to a compact set of cargo commands.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

A rabbit hops through pages bright,
Trimming words that block the light,
Installation, notes, and smoke so clear,
The path to code is drawing near! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'docs: add concise usage guide' accurately reflects the main change: restructuring the README into a more concise usage guide with simplified installation and configuration sections.
Description check	✅ Passed	The description clearly outlines the changeset (replacing long README with concise guide, documenting Codex/Hermes config, keeping smoke tests) and includes a concrete test plan, all related to the README restructuring.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/concise-usage-guide

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}