AuditViewer

Turn any company, product, market or technology into a complete strategic dossier — in minutes, with one line.

You type a name — Tesla, Notion, the LLM market, Société Générale. A few minutes later you have a structured, sourced, fact-checked research dossier worth what a consulting firm would bill thousands for: history, market sizing, technology, pricing, competition, financials, outlook — each figure backed by a dated source.

AuditViewer is an AI strategic-research assistant made of five parts that work together:

Part	What it is	For whom
🧠 `audit-report` skill	The engine. One command that researches a topic and writes a full dossier.	Anyone with Claude Code or Gemini
🌐 Web viewer	A browser app to launch, watch, and read audits live.	Users who prefer a web UI
🖥️ macOS app	A native Mac app to read, compare and explore audits as a knowledge map.	Mac users
📱 iOS / iPadOS app	A native reader to browse your audits on iPhone & iPad, straight from the Files app.	Mobile readers
📺 Apple TV app	A native reader to view your audits on the big screen, served over your local network.	Boardrooms & presentations

🤝 Works with Claude Code and Gemini — no lock-in. The skill auto-detects your assistant: multi-agent parallel research on Claude, single-context "solo" mode on Gemini. Same report, either way.

Why it exists

Researching a company or a market properly is slow, repetitive work: dozens of searches, cross-checking numbers, chasing official filings, separating fact from hype, then assembling it all into something readable. AuditViewer does that legwork for you and hands back a decision-ready document, not a pile of browser tabs.

It is built around one principle: every number is sourced and dated. The AI is explicitly instructed never to invent figures, to tag each source as Official / Analyst / Press, to flag data older than a year, and to cross-check the key numbers against at least two independent sources.

What you actually get

Run one command and you get a folder of ready-to-read documents:

File	What's inside
Executive summary	One page: key facts, headline figures, verdict
History	Origins, milestones, pivots, acquisitions, controversies
Market	Market size (TAM/SAM/SOM), growth, geography, regulation
Technology	Product, architecture, features, differentiators, patents
Pricing	Price tiers, business model, sector comparison
Competition	Competitive map, market shares, positioning, SWOT
Financials	Revenue, funding, valuation, key metrics
Outlook	Roadmap, weak signals, risks, scenarios
Full report	Everything merged into one paginated, shareable document

Optional add-ons let you generate a dedicated SWOT, an ESG / sustainability chapter, an HR & culture chapter, or a single-page brief.

👉 See a real example and a guided walkthrough in the getting-started guide.

See it in action

_{Obsidian-style map — the subject, its dimensions and ~180 sources, linked.}	_{Live timeline — watch an audit run, event by event.}
_{Dimension view — structured analysis (here, the competitive landscape).}	_{Full report — assembled, ready to read or share.}

Shown: the web viewer. The same audits open in the native macOS app.

Who it's for

Decision-makers & analysts — due diligence before an investment, competitive monitoring, market studies. Get in minutes what normally takes days of desk research. → Use cases
Curious non-experts — understand a company, a product or an industry without wading through jargon. The reports read like a briefing, not a spreadsheet.
Developers & contributors — the skill speaks a documented, versioned machine contract so you can build your own tools on top of it.

How it works, in three steps

You ask. /audit-report Tesla — optionally choosing depth, language, and extra chapters.
The AI investigates. It does a quick reconnaissance, confirms the scope with you, then researches each dimension in parallel, fact-checks the key numbers, and assembles the report.
You read & explore. Open the folder directly, or use the web viewer / Mac app to follow progress live, browse chapters, and see how audits connect to each other.

A deeper, still-non-technical explanation lives in How it works.

Quick start

New to this? Start with the getting-started guide — it assumes no technical background.

1 — The `audit-report` skill (the engine)

Requires Claude Code or Gemini.

Option A — from Claude Code (recommended), via the plugin marketplace:

/plugin marketplace add vincentlauriat/toolkit
/plugin install audit-report@vincentlauriat-toolkit

Option B — from the cloned repo, via the install script:

./install.sh            # install for Claude Code (~/.claude/skills)
./install.sh --gemini   # install for Gemini (~/.gemini/config/skills)
./install.sh --copy     # copy instead of symlink

Then, inside your AI assistant:

/audit-report Apple
/audit-report "Tesla Model Y"
/audit-report "le marché des LLM" --lang fr
/audit-report Notion --depth quick

Reference: skills/audit-report/SKILL.md.

2 — The web viewer

Requires Node.js.

cd web
npm install
npm run dev    # backend on :3001, frontend on :5173 → open http://localhost:5173

By default the viewer reads audits from ~/Documents/Research. Point it elsewhere with AUDITS_ROOT:

AUDITS_ROOT=/path/to/your/audits npm run dev

Details: web/README.md.

3 — The macOS app

Download the latest signed .dmg — notarized by Apple, auto-updating (Sparkle). Drag it to Applications and you're done.

_{Native knowledge map — subject, sections, sources and key people.}	_{Fact-check — key figures re-verified against independent sources.}
_{Native Markdown — rich rendering with tables and sections.}	_{Key figures — structured data extracted from the audit.}

Two ways to open audits:

Direct mode (⌘O — "Open an audit folder…") — point to a single audit folder; the report opens immediately.
Root mode (⇧⌘O — "Open a root folder…", also a button on the home screen) — point to a folder that contains several audit sub-folders; the app shows a full-screen list of all audits found (title, date, source count, depth, status badge). Click any audit to open it; a "‹ Audits" button returns to the list. This is the macOS equivalent of the multi-audit browser already on iPhone & iPad. An audit is detected by the presence of _manifest.json or 00_RESUME_EXECUTIF.md in a sub-folder. The root folder is remembered between sessions.

Or build from source (macOS 15+, Swift toolchain):

cd mac
./build.sh
open build/AuditViewer.app

Details: mac/README.md.

4 — The iOS / iPadOS app

A native read-only reader for iPhone & iPad: browse your audits and read each dimension and the full Markdown report on the go. It opens your existing Research folder straight from the Files app (iCloud Drive or "On My iPhone") — pick the folder once and the app remembers it.

Build from source (iOS 17+, Xcode + XcodeGen):

cd mac
xcodegen generate
xcodebuild -scheme AuditViewerIOS -destination 'generic/platform=iOS Simulator' build

Scope is read-only — launching audits and the link map stay on Mac/Web. Sources live under mac/ios/.

5 — The Apple TV app

A native read-only reader for Apple TV: view your audits on the big screen — in meetings, presentations, the boardroom. It shows the audit list, the summary (title, status, KPIs, badges), dimensions (drill-down), sources and the full Markdown report, with native SwiftUI rendering and Siri Remote navigation.

Since tvOS has no file picker, no iCloud Drive and no persistent local storage, the Mac shares its Research folder over your local network: the macOS app exposes a small read-only HTTP server published via Bonjour (_auditviewer._tcp). Turn on "Share on local network" in the Mac app (off by default), and the Apple TV discovers the Mac automatically and reads the audits over a REST API. Everything stays on the LAN — no cloud.

Build from source (tvOS 17+, Xcode + XcodeGen):

cd mac
xcodegen generate
./tvos/build.sh           # build & run on the tvOS Simulator
./tvos/build.sh <UDID>    # or target an Apple TV paired to Xcode over Wi-Fi

Scope is read-only — launching audits and the link map stay on Mac/Web. Sources live under mac/tvos/.

Documentation

Guide	For
Getting started	Your first audit, step by step — no jargon
Use cases	Concrete scenarios by profession
How it works	The concepts, in plain language
FAQ	Common questions answered
Glossary	Every technical term, demystified
Architecture	The machine contract, for developers

French versions live under docs/fr/.

Under the hood: the machine contract

The viewers stay in sync because the skill writes its output as a deterministic, versioned "machine contract" (v1): a real-time event stream (_events.jsonl), a two-way control channel (_control.json), an interactive question/answer cycle, and canonical structured outputs (_manifest.json, _data.json, _sources.json). Any tool that reads this contract can display or drive an audit.

Full specification: ARCHITECTURE.md.

Repository layout

Folder	Role
`skills/audit-report/`	The AI audit skill (Claude Code / Gemini)
`web/`	Web viewer & control UI (Node + React)
`mac/`	Native macOS app (SwiftUI)
`mac/ios/`	Native iOS / iPadOS reader app (SwiftUI)
`mac/tvos/`	Native Apple TV (tvOS) reader app (SwiftUI)
`docs/`	User documentation (this guide set)
`images/`	Illustrations used in the docs

Cross-platform

The same machine contract runs everywhere; only the internal execution engine differs.

Platform	Recommended mode	Mechanism
Claude Code	`parallel` or `sequential`	Multi-agent orchestration
Gemini / Antigravity	`solo`	Single large-context run

Name		Name	Last commit message	Last commit date
Latest commit History 52 Commits
docs		docs
images		images
mac		mac
skills		skills
web		web
.gitignore		.gitignore
ANNOUNCEMENT.md		ANNOUNCEMENT.md
ARCHITECTURE.md		ARCHITECTURE.md
CHANGES.md		CHANGES.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
PLAN.md		PLAN.md
PLAN_TVOS.md		PLAN_TVOS.md
README.fr.md		README.fr.md
README.md		README.md
TODOS.md		TODOS.md
install.sh		install.sh

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

AuditViewer

Why it exists

What you actually get

See it in action

Who it's for

How it works, in three steps

Quick start

1 — The `audit-report` skill (the engine)

2 — The web viewer

3 — The macOS app

4 — The iOS / iPadOS app

5 — The Apple TV app

Documentation

Under the hood: the machine contract

Repository layout

Cross-platform

License

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

AuditViewer

Why it exists

What you actually get

See it in action

Who it's for

How it works, in three steps

Quick start

1 — The audit-report skill (the engine)

2 — The web viewer

3 — The macOS app

4 — The iOS / iPadOS app

5 — The Apple TV app

Documentation

Under the hood: the machine contract

Repository layout

Cross-platform

License

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

1 — The `audit-report` skill (the engine)

Packages