Guide

Keys live in the .env file (never in the app). The checklist on the right shows whether they are all in place. After changing .env, restart the app.

The profile is the only source of JADA facts. Ideas and relevance scores are built from it, and the agent never invents positioning. Review the YAML, correct anything, set status: approved and press Validate & save.

Press ✨ Run discovery (about a minute). It searches the web from your profile and proposes ranked candidates. Each card shows an overlap score, a category (direct / indirect / adjacent), a rationale, and source links for the evidence. Candidates without a real source link are discarded automatically. You can also + Add manually.

Only approved competitors are ever monitored. ✓ Approve adds them and auto-detects their sources (blog feed, key pages, news). Watch later and Reject are remembered. Start with 3 to 5 competitors so the first digest is easy to judge.

Open the Approved tab. If a competitor shows an amber Confirm banner, click the link, check it is really their company page, then press Confirm. LinkedIn posts are pulled through Apify only after you confirm, so the wrong page is never monitored. You can add, disable or enable sources per competitor here.

On Overview → Run a digest, choose Daily, tick First-run preview (last 7 days), leave Send to recipients unticked and press ▶ Run now. The stages stream live: collect → analyse → synthesise → ideas → QA → deliver. The first run can take several minutes because it also collects the 90-day baseline.

Open the digest. You see the email as recipients will (toggle Desktop / Mobile, or Plain text). On the right:

• QA gate: citation, quote, number, labelling, JADA-fact, compliance and render checks. Anything that fails is removed, not sent.
• Evidence lineage: every claim maps to stored items (see them in the Activity feed).

Things to look for: every statement links to a source, interpretations are labelled Our read, and the Data notes block lists anything unavailable.

See a post worth including? Paste its URL and text under Manual input. It is deduplicated, analysed and used in the next digest. Pasted text is treated as data only.

In the digest's Delivery panel, type a test address and press Send this digest. Sending goes through Brevo. Once sent, the same posts are never reported again and a second send is refused unless you press Resend (force). To send straight from a run, tick Send to recipients on Overview.

• Daily / weekly: pick the cadence on Overview and press Run now. (Automatic scheduling is not built yet.)
• Feedback: the 👍/👎 links in each email teach the topic weighting.
• Something failed? Runs & audit shows every stage, cost and error. A source that fails 3 times in a row is switched to failing and skipped; re-enable it from the Competitors page.
• Monthly: run discovery again. It only proposes new names and never removes approved ones.
• Remove a competitor: Delete all data on its card erases it and everything collected about it.