From 1837d315cd0ead36622bda313196bddb67bbcad8 Mon Sep 17 00:00:00 2001 From: xwchris Date: Sat, 8 Aug 2026 17:28:46 +0800 Subject: [PATCH] Reposition Bellwire README for AI-native founders Signed-off-by: xwchris --- README.md | 97 +++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 73 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index fffa193..f5d3f65 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,10 @@
Bellwire app icon

Bellwire

-

Live project state and AI agent events, delivered as native cards and notifications on iPhone.

+

The AI-first iPhone project radar for indie hackers and AI-native founders.

Website · + App Store · Quick Start · Self-host · ClawHub · @@ -17,18 +18,73 @@

-Bellwire turns live project state and typed events into native iPhone cards, an -inbox, and APNs notifications. New projects use **Private** delivery by default: -Bellwire relays a content-free wake, while the iPhone fetches notification, -Inbox, and Surface details directly from your signed HTTPS service. **Hosted** -delivery is an explicit, user-approved option for projects that prefer Bellwire -Cloud to store and render those details. +## Know what every project earns — and when it needs you -Use [Bellwire Cloud](https://bellwire.app) or connect a self-hosted deployment. -The hosted API is available at +If you are building several products with Codex, Claude Code, or another coding +Agent, the hard part is no longer shipping one more feature. It is keeping track +of what every project is earning, what is still running, and what quietly broke. + +Bellwire puts the small set of signals that actually need your attention on +your iPhone: + +- revenue, payments, refunds, orders, and useful growth signals; +- deployments, API health, incidents, and recoveries; +- long-running Agent jobs, progress, and decisions waiting on you; +- a durable cross-project event inbox after a notification disappears. + +You do not configure a dashboard builder or hand-wire another notification +pipeline. Tell your coding Agent what matters. It inspects the real project, +connects the source, deploys the adapter, and verifies one genuine signal end to +end. + +> [!NOTE] +> Bellwire is intentionally Agent-first, not a catalog of pretend one-click +> integrations. Your Agent works with the repository and data sources you +> already use, while pairing and sensitive delivery choices stay under your +> control on iPhone. + +## From a request to a live project radar + +1. **Create a project on iPhone.** Bellwire gives you a one-time binding code. +2. **Hand the job to your coding Agent.** Describe the revenue, project state, + and moments that deserve your attention. +3. **Verify the real loop.** The Agent connects the source, deploys the data + path, and proves that a real payment, deployment, incident, or job reaches + Bellwire. + +Give this to Codex, Claude Code, or another coding Agent: + +```text +Connect this project to Bellwire. Keep today's revenue, refunds, active users, +the production deploy, and API health visible. Notify me when something needs +attention. Keep it Private and verify one real signal end to end. +``` + +Start with the [Private-first quick start](docs/quickstart.md) or install the +published [Bellwire Agent Skill](https://clawhub.ai/xwchris/skills/bellwire). + +## See the current app + +

+ Bellwire dark Home screen showing live project status and recent events + Bellwire dark Projects screen with connected products + Bellwire dark Events inbox showing payments and Agent runs +

+ +These are native screenshots from the current SwiftUI build using demo project +data. Watch the native Simulator capture at +[bellwire.app](https://bellwire.app/#film). + +## Private by default, Hosted by choice + +Every new project starts **Private**. Bellwire relays a content-free wake, while +the iPhone fetches notification, Inbox, and Surface details directly from your +signed HTTPS service. **Hosted** is an explicit, user-approved option when you +prefer Bellwire Cloud to store, render, and operate that data path. + +Use [Bellwire Cloud](https://bellwire.app), or run the complete stack in your +own Apple and Cloudflare accounts. The hosted API is available at [`https://api.bellwire.app`](https://api.bellwire.app). -Product requirements and internal planning documents are intentionally kept -out of this public repository. > [!IMPORTANT] > Bellwire is multi-licensed: the Workers and Cloudflare D1 stack use AGPL-3.0-only, @@ -36,19 +92,12 @@ out of this public repository. > and public docs use Apache-2.0. The Bellwire brand is reserved. See > [LICENSE.md](LICENSE.md) for the exact path boundaries. -Start with the [Private-first quick start](docs/quickstart.md), browse the -[integration examples](examples/README.md), or deploy the full stack with the -[self-hosting guide](docs/self-hosting.md). The repository also publishes an -[OpenAPI 3.1 description](docs/openapi.yaml), [upgrade guide](docs/upgrading.md), -[telemetry contract](docs/telemetry.md), and [security model](docs/security-model.md). - -## See Bellwire in action - -

- Bellwire home screen with live project cards - Bellwire project management screen - Bellwire event inbox -

+Browse the [integration examples](examples/README.md), deploy the full stack +with the [self-hosting guide](docs/self-hosting.md), or use the +[OpenAPI 3.1 description](docs/openapi.yaml). The repository also publishes an +[upgrade guide](docs/upgrading.md), [telemetry contract](docs/telemetry.md), and +[security model](docs/security-model.md). Product requirements and internal +planning documents are intentionally kept out of this public repository. ## Choose a deployment