# Walkthru {#walkthru}

## How it works {#howitworks}

"Aigon", the Walkthru agent is designed for professionals in the building
industry who need to capture what you see on site. Everything is captured using
WhatsApp, simply by sending **text** or **voice notes**, **images** or
**videos** to Aigon's [WhatsApp number](https://wa.me/447477156095).

During or after the session, a full report is generated in various formats
depending on what you want to do with them. If you are already using Claude or ChatGPT you can also connect Aigon directly to your favorite LLM via MCP, and you can **work on your notes directly**, and in the moment you've taken them, without the need to generate a report first.

## Quick start {#quickstart}

- [Sign up](#signup) to Walkthru by [clicking here](/promotion/walkthru) and hitting SEND.
- Start a new session by typing [/new](https://wa.me/447477156095?text=%2Fnew%20exampleproject)
- Send text and voice [notes](#takenotes), images, videos and documents for the report
- Create the [interim report](https://wa.me/447477156095?text=%2Freport) or the [final report](https://wa.me/447477156095?text=%2Ffinal%20yes)
- Work with your reports [directly](#workwithreports) or using an LLM [via JSON](#json) or [via MCP](#mcp)

# Sign up {#signup}

Sign up is simple. You simply send the following WhatsApp message to Aigon on
[+44 7477 156095](https://wa.me/447477156095)

> [/start join wtwa26](/promotion/walkthru)

You can do this automatically by clicking [this link](/promotion/walkthru), or the button below.

<a href="/promotion/walkthru" class="wa-cta">
  <svg viewBox="0 0 24 24" width="72" height="72" role="img" aria-label="WhatsApp" fill="#25D366">
    <path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 01-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 01-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 012.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0012.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 005.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 00-3.48-8.413z"/>
  </svg>
  <span>Talk to Aigon</span>
</a>

Either route opens WhatsApp with the message already written — all you need to do is **hit SEND** to
connect your WhatsApp account to Aigon.

# Reporting session {#session}

A **reporting session** generates one report. You

- start a [new session](#new) for each property visit,
- send [notes](#takenotes) to Aigon during the visit,
- generate [interim reports](#interim) whenever you want to see how it is
  shaping up, and
- generate the [final report](#final) when the visit is done and the interim
  report is shaping up nicely.

## Start a new session {#new}

You start a session by [sending](https://wa.me/447477156095?text=%2Fnew%20)

> [/new <session name>](https://wa.me/447477156095?text=%2Fnew%20exampleproject)

where the session name must be at least six characters long and should be
unique — adding a date is an easy way, eg [/new newgate-2026-05-12](https://wa.me/447477156095?text=%2Fnew%20exampleproject).

Here are screenshots from an example walkthru. First we use

> /help

to remind us of the available commands. Then we use

> /new examplereport

to start a new reporting session.

<div class="img-pair">
<img src="01-help.jpg" alt="The /help output, listing the commands">
<img src="02-start-session.jpg" alt="/new examplereport starting a session">
</div>

## Take notes {#takenotes}

Consider Aigon your colleague back at the office, and send them whatever you
find notable during your visit.

- **Text** — if you want to type notes or use your own transcription service like [Wispr Flow](https://wisprflow.ai/) you can simply send text notes.
- **Voice notes** — are generally easier to send, and therefore richer in content; send the message in any language you want, and Aigon will transcribe it for you, clean it up, and translate it to English (or any language of your choice)
- **Photos** — attach them to a note you are sending or on your own; they are [consolidated](#consolidation) with the relevant note, described and the text found on them is transcribed and searchable
- **Videos** - you can attach them like photos to a message, or use [video mode](#videomode) to make them their own message; in any case, video text is transcribed and searchable
- **Documents** - you can attach documents to a note, and Aigon will extract the text and make it searchable as well

The following pictures show the progress of the example report. First there was a voice note (outside the screenshot) that got transcribed to _"So the following pictures are of the living room"_. Then there is another voice note visible that is transcribed to _"So the cornices here..."_. Then there is a message with three images and one video and no caption, which is therefore consolidated into the cornices message. Moving on there is another voice message transcribed to _"Also the white paint..."_ and again another no-caption message, this time holding five images. Those are consolidated with the paint message.

<div class="img-pair">
<img src="03-notes-living-room.jpg" alt="Voice note and photos of the living room">
<img src="04-notes-door.jpg" alt="Door paint cracking, with photos">
</div>

## Image consolidation {#consolidation}

By default, photos, videos and documents that are sent without a caption are **attached to the previous note**, provided this note is less than five minutes old. This is particularly useful when using voice messages because it is not possible to add attachments to a voice message.

If you prefer that they are **attached to the following note** instead, send

> [/cons next](https://wa.me/447477156095?text=%2Fcons%20next)

at any point. To go back to the default, send

> [/cons previous](https://wa.me/447477156095?text=%2Fcons%20previous)

and [/cons](https://wa.me/447477156095?text=%2Fcons) alone shows the current setting.

## Video mode {#videomode}

By default, videos are treated as attachments to the previous or next note, depending on the [consolidation settings](#consolidation). In this case the note text is whatever was recorded for the note, and the text transcribed from the video (if any) is kept as a separate attachment.

Sometimes the following workflow is more convenient:
1. you send a video note, recording the big-picture situation together with voice commentary, and
2. attach photos of detailed features to that video note.

This is the video mode that you turn on with

> [/vm on](https://wa.me/447477156095?text=%2Fvm%20on).

In this mode, each video sent creates a new note, and the note text is the video transcript. Document and image consolidation works [as usual](#consolidation), so with the default setting if you send a video with comments first and then detailed images they'll all end up in the same note, with the note text being the transcript of the video.

To go back to the default mode use

> [/vm off](https://wa.me/447477156095?text=%2Fvm%20off)

and [/vm](https://wa.me/447477156095?text=%2Fvm) alone shows the current setting.

Here is an example. Video mode is switched on, then a video is recorded — and
the transcript of what was said while filming becomes the note text.
Photographs sent afterwards fold into that same note, exactly as they would
under any other note, and each is described as it arrives.

<div class="img-pair">
<img src="14-video-mode-on.jpg" alt="Video mode switched on, and the video transcribed into the note">
<img src="15-video-mode-photos.jpg" alt="Photographs folding into the video note">
</div>

# Creating reports {#createreports}

## Interim reports {#interim}

Send

> [/report](https://wa.me/447477156095?text=%2Freport)

to create an interim report. The assistant cleans up the notes with an LLM,
groups them into findings, and sends back three things: a link to the report in
the web app, a public link for feeding to an LLM, and a PDF.

![The /report command and its three outputs](06-report-command.jpg)

Interim reports are drafts. They expire after a few days, and you can regenerate
one as often as you like — nothing is fixed until you close the session.

## More notes or explanations {#more}

Reading the interim report may show that something is missing. You can carry on
sending notes into the same session. Those notes can just be more of the same,
or explanations like

> When I mentioned the sitting room, I actually meant the dining room. There's a
> living room with couch and TV, and there is a dining room with a dining table.
> There is no other sitting room, and the term sitting room is ambiguous, so do
> not use it.

or

> Also, I forgot to mention that the property is at 1 Park Lane in London. And I
> went there with John Smith, who is overlooking the restoration works.

Those corrections will be taken into account the next time you generate a
report. See below how this looks in our example.

<div class="img-pair">
<img src="16-correction-report.jpg" alt="A correction sent as a voice note, then /report">
<img src="17-correction-details.jpg" alt="The new interim report, and further details added">
</div>

## Final report {#final}

When the visit is done, send

> [/final yes](https://wa.me/447477156095?text=%2Ffinal%20yes)

to close the session. The `yes` is the
confirmation and is required — it is a reminder that this operation **cannot be undone**.

The final version is kept permanently in the web app rather than expiring, and a
new empty session opens behind it.

# Working with reports {#workwithreports}

Every report is produced in four formats at once. Use [/wl](https://wa.me/447477156095?text=%2Fwl) for a login link to
the web app, where all of them are listed.

## PDF {#pdf}

The read-and-send format: a title page with the details of the visit, an
LLM-written summary, the findings as a numbered list, and then every note in
order with its photographs.

<div class="img-pair">
<img src="07-report-pdf.jpg" alt="The report PDF">
<img src="08-report-pdf-detail.jpg" alt="Per-note detail in the PDF">
</div>

## Word {#word}

The same report as a `.docx` Word document, for when it is the starting point for you to review. The Word document can be created in your house style, using your own branding and templates.

## LLM via JSON {#json}

All report data can be obtained using a private link to a JSON document that you can paste into your favorite LLM who can then generate the report. The LLM has access to all notes, and all the images, videos and documents uploaded. Best for when the report requires some post-processing that you do not want to do yourself.

Tell the model to **open** the link rather than search for it. If it will not,
open the link in a browser and paste the contents in.

## LLM via MCP {#mcp}

If your assistant speaks MCP, it can reach your notes directly — no links to
paste, and no need to have generated a report first. It can pull the
attachments too, so you can ask about a specific photograph rather than about
the text alone.

Setting that up is covered in **[Connecting MCP servers](/docs/connecting-mcp/)**:
the three access points, logging in by link or QR code, bearer tokens for
clients that cannot do OAuth, and step-by-step instructions for Claude and for
ChatGPT.

<div class="img-pair">
<img src="12-mcp-read-notes.jpg" alt="Claude reading recent Walkthru notes over MCP">
<img src="13-mcp-attachments.jpg" alt="Claude fetching photographs from the notes">
</div>

# Troubleshooting {#troubleshooting}

## Allow permissions in Claude {#permissions}

Claude may refuse to download from Aigon unless specifically allowed. If this is
the case go to [claude.ai](https://claude.ai) and log into your account. Bring up
the menu bar by touching the button located in the top left and then open the
**Customize** menu. On the modal that appears choose the **Capabilities** tab and
scroll down to **Allow network egress**. You can choose **All domains**, as in the
screenshot below.

<div class="img-pair">
<img src="18-claude-customize.jpg" alt="The Claude menu bar, with Customize">
<img src="11-claude-capabilities.jpg" alt="Capabilities, with the domain allowlist set to All domains">
</div>

Alternatively you can choose **None** or **Package managers only** and then add
**Additional allowed domains**. The main domain required for aigon is

> `*.aigon.ai`

<div class="img-pair">
<img src="19-egress-none.jpg" alt="Domain allowlist set to None, with *.aigon.ai added">
<img src="20-egress-package-managers.jpg" alt="Domain allowlist set to Package managers only, with *.aigon.ai added">
</div>

Note that those settings only take effect for new sessions.
