Skip to content

docs: improve README with value-focused messaging and Chinese translation#2

Open
sujayjayjay wants to merge 1 commit intomasterfrom
improve-readme-value-prop
Open

docs: improve README with value-focused messaging and Chinese translation#2
sujayjayjay wants to merge 1 commit intomasterfrom
improve-readme-value-prop

Conversation

@sujayjayjay
Copy link
Copy Markdown
Contributor

Summary

  • Value-focused tagline: Replace generic description with action-oriented messaging: "An open-source Claude desktop app that doesn't just chat — it takes action."
  • "Why This One?" section: Added comparison table highlighting the key differentiator (800+ tool integrations vs typical GUI wrappers)
  • "What You Can Do" section: Added 4 concrete use cases showing real-world value (Developer Workflow, Email Triage, Meeting Prep, Code + Communicate)
  • Chinese README: Added README_ZH.md with full translation and proper language switcher
  • Community badges: Added Discord and GitHub Stars badges
  • Accuracy update: Updated tool count from 500+ to 800+

Why these changes?

Based on competitive analysis, the current README reads like a technical feature list. Competitors with higher star velocity (Claude-Cowork at 340 stars/day vs this repo at 52 stars/day) lead with:

  1. Clear problem-solution framing
  2. Immediate differentiation
  3. Concrete use cases
  4. Multi-language support

The key differentiator (800+ real tool integrations via Composio) was buried. This PR puts it front and center.

Before/After

Before tagline:

An open-source desktop chat application powered by Claude Agent SDK and Composio Tool Router. Build AI agents with access to 500+ tools and persistent chat sessions.

After tagline:

An open-source Claude desktop app that doesn't just chat — it takes action.
Send emails, create PRs, manage calendars, post to Slack — all from natural language prompts.
Powered by 800+ tool integrations via Composio.

Test plan

  • Verify README renders correctly on GitHub
  • Verify Chinese README renders correctly
  • Verify language switcher links work both ways
  • Verify all badge links work

🤖 Generated with Claude Code

…tion

- Replace generic tagline with action-oriented value proposition
- Add "Why This One?" section with comparison table showing key differentiators
- Add "What You Can Do" section with concrete use cases
- Add Discord badge and GitHub stars badge
- Add language switcher linking to Chinese README
- Update tool count from 500+ to 800+ for accuracy
- Add Chinese README (README_ZH.md) for broader reach

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@sujayjayjay sujayjayjay requested a review from Prat011 January 18, 2026 11:14
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