whoami.wiki

https://whoami.wiki/docs
Admin
whoami.wiki is a personal encyclopedia that uses AI agents to transform personal data sources like...
Tokens:13,171
Snippets:220
Trust Score:6.5
Update:6 months ago
Show doc for...
Tokens:
Raw
### Install whoami.wiki CLI

Source: https://whoami.wiki/docs/installation

Installs the `wai` command-line tool using a curl script. This tool is essential for agents to interact with the wiki.

```bash
curl -fsSL https://whoami.wiki/cli/install.sh | bash

```

--------------------------------

### Install whoami.wiki Extension for Codex

Source: https://whoami.wiki/docs/installation

Sets up the whoami.wiki extension for Codex by cloning the repository and copying configuration files. This enables the editor agent and editorial guide skill.

```bash
git clone https://github.com/whoami-wiki/extensions.git

```

```bash
cp -r extensions/codex/.agents .agents

```

--------------------------------

### Install the CLI tool

Source: https://whoami.wiki/docs

Use this command to install the 'wai' command-line interface required for agent interactions.

```bash
curl -fsSL https://whoami.wiki/cli/install.sh | bash
```

--------------------------------

### Install the Claude Code plugin

Source: https://whoami.wiki/docs

Run these commands within the Claude Code interface to add and install the whoami marketplace plugin.

```text
/plugin marketplace add whoami-wiki/extensions
/plugin install whoami@whoami-marketplace
```

--------------------------------

### Verify CLI connection and functionality

Source: https://whoami.wiki/docs

Use these commands to check authentication status and perform a test search to ensure the setup is working correctly.

```bash
wai auth status
```

```bash
wai search "test"
```

--------------------------------

### Install whoami.wiki Extension for Claude Code

Source: https://whoami.wiki/docs/installation

Installs the whoami.wiki plugin for Claude Code via marketplace commands. This provides Claude Code with wiki tools and an editor agent.

```bash
/plugin marketplace add whoami-wiki/extensions

```

```bash
/plugin install whoami@whoami-marketplace

```

--------------------------------

### Install whoami.wiki Extension for OpenCode

Source: https://whoami.wiki/docs/installation

Configures the whoami.wiki extension for OpenCode by cloning the repository and copying specific files. This sets up the necessary directories and plugin for `wai` CLI integration and context preservation.

```bash
git clone https://github.com/whoami-wiki/extensions.git

```

```bash
cp -r extensions/opencode/.opencode .opencode

```

```bash
cp extensions/opencode/opencode.json opencode.json

```

--------------------------------

### Verify whoami.wiki Search Functionality

Source: https://whoami.wiki/docs/installation

Tests the end-to-end functionality of the whoami.wiki setup by performing a search query using the `wai` CLI.

```bash
wai search "test"

```

--------------------------------

### Wiki Page Structure Example

Source: https://whoami.wiki/docs/citation-system

Illustrates the typical ending sections of a person or episode page, including references and bibliography templates.

```wikitext
== References ==
<references />

== Bibliography ==
{{Cite vault|type=messages|snapshot=a1b2c3d4e5f6
|timestamp=2021-03-01/2022-05-15|note=Instagram DM thread with Jane Doe}}
{{Cite vault|type=voice_notes|snapshot=b2c3d4e5f6a1
|timestamp=2021-04-12/2021-06-03|note=47 voice notes, Jane and wiki owner}}
```

--------------------------------

### Reinstall Agent Plugin

Source: https://whoami.wiki/docs/troubleshooting

Remove and re-add the plugin if it is installed but not detected by the agent.

```bash
claude plugin remove whoami
claude plugin add whoami
```

--------------------------------

### Get Connection Status JSON

Source: https://whoami.wiki/docs/troubleshooting

Retrieve detailed connection status in JSON format for debugging purposes.

```bash
wai auth status --json
```

--------------------------------

### Configure OpenCode extension

Source: https://whoami.wiki/docs

Clone the extensions repository and copy the OpenCode configuration files into your working directory.

```bash
git clone https://github.com/whoami-wiki/extensions.git
cp -r extensions/opencode/.opencode .opencode
cp extensions/opencode/opencode.json opencode.json
```

--------------------------------

### Configure Wiki Port

Source: https://whoami.wiki/docs/troubleshooting

Update the port in the configuration file if the default port is already in use.

```json
{ "wiki": { "port": 8081 } }
```

--------------------------------

### Log in to wiki

Source: https://whoami.wiki/docs/cli

The `wai auth login` command stores wiki credentials. It prompts interactively for missing values or accepts them via flags.

```bash
wai auth login

```

```bash
wai auth login --server http://localhost:8080 --username admin --password secret

```

--------------------------------

### Verify CLI Connection

Source: https://whoami.wiki/docs/troubleshooting

Check if the CLI can successfully communicate with the wiki instance.

```bash
wai auth status
```

--------------------------------

### Import wiki backup

Source: https://whoami.wiki/docs/cli

Use `wai import` to restore a wiki from a backup archive. The `--force` flag overwrites existing data, and `--dry-run` previews the backup contents without restoring.

```bash
wai import ~/backups/whoami-2023-12-01.tar

```

```bash
wai import backup.tar --force

```

```bash
wai import backup.tar --dry-run

```

--------------------------------

### List Source Namespace Pages

Source: https://whoami.wiki/docs/cli

Lists all pages within the 'Source' namespace.

```bash
wai source list
```

--------------------------------

### wai create

Source: https://whoami.wiki/docs/cli

Creates a new wiki page.

```APIDOC
## wai create

### Description
Create a new page.

### Parameters
#### Path Parameters
- **title** (string) - Required - The title of the new page.

#### Flags
- **-c, --content** (string) - Optional - Provide content inline.
- **-f, --file** (string) - Optional - Read content from a file path.
- **-m, --summary** (string) - Optional - Edit summary.
```

--------------------------------

### Create New Wiki Page

Source: https://whoami.wiki/docs/cli

Creates a new wiki page. Content can be provided inline (-c), from a file (-f), or via standard input. An edit summary can be added with -m.

```bash
wai create "New Page" -c "Page content"
```

```bash
wai create "New Page" -f draft.txt -m "Initial draft"
```

```bash
echo "content" | wai create "New Page"
```

--------------------------------

### Export wiki backup

Source: https://whoami.wiki/docs/cli

The `wai export` command creates a full wiki backup as a tar archive. Use `--dry-run` to preview the export without writing.

```bash
wai export ~/backups

```

```bash
wai export ~/backups --dry-run

```

--------------------------------

### Configure Codex extension

Source: https://whoami.wiki/docs

Clone the extensions repository and copy the necessary configuration files into your working directory.

```bash
git clone https://github.com/whoami-wiki/extensions.git
cp -r extensions/codex/.agents .agents
```

--------------------------------

### List Sections of a Page

Source: https://whoami.wiki/docs/cli

Lists all sections of a specified wiki page.

```bash
wai section list "Summer 2023"
```

--------------------------------

### Snapshot a directory

Source: https://whoami.wiki/docs/cli

Use `wai snapshot` to create a content-addressable vault snapshot of a directory and generate a Source page. The `--dry-run` flag previews the operation without writing.

```bash
wai snapshot ~/Photos/summer-2023

```

```bash
wai snapshot ~/exports/chat-logs --name "WhatsApp 2023"

```

```bash
wai snapshot ~/data --dry-run

```

--------------------------------

### List Categories

Source: https://whoami.wiki/docs/cli

Lists all categories in the wiki, or pages within a specific category if a category name is provided.

```bash
wai category
```

```bash
wai category "Trips"
```

--------------------------------

### Upload File to Wiki

Source: https://whoami.wiki/docs/cli

Uploads a file to the wiki. The --name flag can override the wiki filename, and -d or -m can add a description or comment.

```bash
wai upload photo.jpg
```

```bash
wai upload photo.jpg --name "Vacation_Photo.jpg"
```

```bash
wai upload photo.jpg -d "Photo from vacation" -m "Upload vacation photo"
```

--------------------------------

### Create a new task

Source: https://whoami.wiki/docs/cli

The `wai task create` command adds a new task to the queue. A message describing the task is required. Optionally, associate the task with a source using the `--source` flag.

```bash
wai task create -m "Write page about summer trip"

```

```bash
wai task create -m "Categorize recent uploads" --source snapshot-abc123

```

--------------------------------

### wai backup

Source: https://whoami.wiki/docs/cli

Export and import wiki backups.

```APIDOC
## GET wai export

### Description
Export a full wiki backup as a tar archive.

### Method
GET

### Endpoint
wai export <path>

### Parameters
#### Path Parameters
- **path** (string) - Required - Destination path.
#### Query Parameters
- **--dry-run** (boolean) - Optional - Preview what would be exported without writing

## POST wai import

### Description
Import from a backup archive.

### Method
POST

### Endpoint
wai import <file>

### Parameters
#### Path Parameters
- **file** (string) - Required - Path to the backup archive.
#### Request Body
- **--force** (boolean) - Optional - Overwrite existing data
- **--dry-run** (boolean) - Optional - Preview backup contents without restoring
```

--------------------------------

### Look up places using Google Places API

Source: https://whoami.wiki/docs/cli

Use the `wai place` command to search for locations. Requires a Google Places API key. The `--limit` flag can specify the maximum number of results.

```bash
wai place "Eiffel Tower"

```

```bash
wai place "coffee shops near me" --limit 10

```

--------------------------------

### Verify whoami.wiki CLI Authentication

Source: https://whoami.wiki/docs/installation

Checks if the `wai` CLI can successfully connect to the whoami.wiki service.

```bash
wai auth status

```

--------------------------------

### Read Wiki Page

Source: https://whoami.wiki/docs/cli

Reads a wiki page. Use --raw for unformatted output or --section to read a specific section. --offset and --limit control the output range.

```bash
wai read <title>
```

```bash
wai read "Summer 2023" --raw
```

```bash
wai read "Summer 2023" --section 2
```

```bash
wai read "Summer 2023" --offset 10 --limit 50
```

--------------------------------

### Show Recent Changes

Source: https://whoami.wiki/docs/cli

Displays recent changes across the wiki. Use --limit to specify the maximum number of changes shown.

```bash
wai changes
```

```bash
wai changes --limit 20
```

--------------------------------

### Restart Docker Container

Source: https://whoami.wiki/docs/troubleshooting

Restart the wiki container if it is offline or unreachable.

```bash
docker restart whoami-wiki
```

--------------------------------

### wai write

Source: https://whoami.wiki/docs/cli

Overwrites an entire wiki page with new content.

```APIDOC
## wai write

### Description
Write (overwrite) an entire page.

### Parameters
#### Path Parameters
- **title** (string) - Required - The title of the page to write.

#### Flags
- **-c, --content** (string) - Optional - Provide content inline.
- **-f, --file** (string) - Optional - Read content from a file path.
- **-m, --summary** (string) - Optional - Edit summary.
```

--------------------------------

### Show Page Links

Source: https://whoami.wiki/docs/cli

Shows incoming and outgoing links for a page. Use --direction to filter by 'in', 'out', or 'both'.

```bash
wai link "Summer 2023"
```

```bash
wai link "Summer 2023" --direction out
```

```bash
wai link "Summer 2023" --direction in
```

--------------------------------

### Create Episode Pages

Source: https://whoami.wiki/docs/writing-your-first-page

Generate individual episode pages for significant events identified within the 'Alex' page. Each episode page will include a narrative, citations, and media, linked from the main person page.

```bash
Create episode pages for the richest events on the Alex page.
```

--------------------------------

### Check Directory Permissions

Source: https://whoami.wiki/docs/troubleshooting

Verify read permissions for the data directory when encountering snapshot errors.

```bash
ls -la ~/Photos/grandma
```

--------------------------------

### wai snapshot

Source: https://whoami.wiki/docs/cli

Snapshot a directory into the content-addressable vault.

```APIDOC
## POST wai snapshot

### Description
Snapshot a directory into the content-addressable vault and create a Source page.

### Method
POST

### Endpoint
wai snapshot <directory>

### Parameters
#### Path Parameters
- **directory** (string) - Required - The directory path to snapshot.
#### Request Body
- **--name** (string) - Optional - Override the source page name
- **--dry-run** (boolean) - Optional - Preview what would be stored without writing
```

--------------------------------

### Update CLI

Source: https://whoami.wiki/docs/cli

Run `wai update` to update the CLI to the latest version. The CLI also checks for updates automatically in the background.

```bash
wai update

```

--------------------------------

### Link to Episode Page

Source: https://whoami.wiki/docs/page-types

Use this syntax to reference a specific episode page within a chronological arc summary.

```text
On 14 August, Jane described a disastrous shoot at Tempelhof
in a series of five voice notes (see [[Jane and the Tempelhof Disaster]]).
```

--------------------------------

### Process Incremental Snapshots

Source: https://whoami.wiki/docs/troubleshooting

Run snapshots on smaller subdirectories to reduce memory usage and processing time.

```bash
wai snapshot ~/Photos/grandma/2020
wai snapshot ~/Photos/grandma/2021
```

--------------------------------

### Add CLI to PATH

Source: https://whoami.wiki/docs/troubleshooting

Manually add the CLI binary directory to your shell PATH if the command is not found.

```bash
# macOS / Linux
export PATH="$HOME/.whoami/bin:$PATH"
```

--------------------------------

### Snapshot WhatsApp Export and Revise Page

Source: https://whoami.wiki/docs/writing-your-first-page

Snapshot a new data source (WhatsApp export) and use it to revise an existing page ('Alex'). This process confirms details, fills gaps, and integrates new facts seamlessly.

```bash
Snapshot ~/Downloads/whatsapp-export and revise the Alex page
with the new data.
```

--------------------------------

### wai upload

Source: https://whoami.wiki/docs/cli

Uploads a file to the wiki.

```APIDOC
## wai upload

### Description
Upload a file to the wiki.

### Parameters
#### Path Parameters
- **file** (string) - Required - The local file path to upload.

#### Flags
- **--name** (string) - Optional - Override the filename on the wiki.
- **-d, --description** (string) - Optional - File description.
- **-m, --comment** (string) - Optional - Upload comment.
```

--------------------------------

### wai auth

Source: https://whoami.wiki/docs/cli

Manage wiki authentication.

```APIDOC
## POST wai auth login

### Description
Store wiki credentials.

### Method
POST

### Endpoint
wai auth login

### Parameters
#### Request Body
- **--server** (string) - Optional - Wiki server URL
- **--username** (string) - Optional - Wiki username
- **--password** (string) - Optional - Wiki password

## POST wai auth logout

### Description
Remove stored credentials.

### Method
POST

### Endpoint
wai auth logout

## GET wai auth status

### Description
Show connection status and stored credential info.

### Method
GET

### Endpoint
wai auth status
```

--------------------------------

### List tasks in the queue

Source: https://whoami.wiki/docs/cli

The `wai task list` command retrieves tasks from the queue. You can filter tasks by their status using the `--status` flag.

```bash
wai task list

```

```bash
wai task list --status pending

```

```bash
wai task list --status in-progress

```

```bash
wai task list --status done

```

```bash
wai task list --status failed

```

--------------------------------

### Read task details

Source: https://whoami.wiki/docs/cli

Use `wai task read` followed by the task ID to view specific task details.

```bash
wai task read <id>

```

--------------------------------

### Search Wiki Pages

Source: https://whoami.wiki/docs/cli

Performs a full-text search across all wiki pages. Use --limit to specify the maximum number of results.

```bash
wai search "tokyo 2023"
```

```bash
wai search "birthday" --limit 20
```

--------------------------------

### Write Wiki Page

Source: https://whoami.wiki/docs/cli

Overwrites an entire wiki page. Content can be provided via inline text (-c), a file (-f), a positional file argument, or standard input.

```bash
wai write "Summer 2023" notes.txt
```

```bash
wai write "Summer 2023" -c "Page content here"
```

```bash
wai write "Summer 2023" -f notes.txt -m "Import notes"
```

```bash
echo "content" | wai write "Summer 2023"
```

--------------------------------

### Read Specific Section

Source: https://whoami.wiki/docs/cli

Reads a specific section of a wiki page. Use --raw for unformatted output. --offset and --limit control the output range.

```bash
wai section read "Summer 2023" 2
```

```bash
wai section read "Summer 2023" 2 --raw
```

--------------------------------

### Log out from wiki

Source: https://whoami.wiki/docs/cli

Use `wai auth logout` to remove stored wiki credentials.

```bash
wai auth logout

```

--------------------------------

### wai task

Source: https://whoami.wiki/docs/cli

Manage tasks in the queue.

```APIDOC
## GET wai task list

### Description
List tasks in the queue.

### Method
GET

### Endpoint
wai task list

### Parameters
#### Query Parameters
- **--status** (string) - Optional - Filter by status: pending, in-progress, done, failed (default: pending)
- **--limit** (number) - Optional - Maximum number of results

## GET wai task read

### Description
Read the details of a specific task.

### Method
GET

### Endpoint
wai task read <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The task ID.

## POST wai task create

### Description
Create a new task.

### Method
POST

### Endpoint
wai task create

### Parameters
#### Request Body
- **-m, --message** (string) - Required - Task description
- **--source** (string) - Optional - Associate the task with a source

## POST wai task claim

### Description
Claim a pending task for processing.

### Method
POST

### Endpoint
wai task claim <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The task ID.

## POST wai task complete

### Description
Mark an in-progress task as completed.

### Method
POST

### Endpoint
wai task complete <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The task ID.
#### Request Body
- **-m, --message** (string) - Optional - Output message to record

## POST wai task fail

### Description
Mark an in-progress task as failed.

### Method
POST

### Endpoint
wai task fail <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The task ID.
#### Request Body
- **-m, --message** (string) - Optional - Failure reason to record

## POST wai task requeue

### Description
Return a failed or in-progress task to the pending queue.

### Method
POST

### Endpoint
wai task requeue <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The task ID.
```

--------------------------------

### Create Talk Page Thread

Source: https://whoami.wiki/docs/cli

Creates a new thread on a page's talk page. Requires a subject (-s) and content (-c or -f). An edit summary can be added with -m.

```bash
wai talk create "Summer 2023" -s "Missing details" -c "What hotel did we stay at?"
```

--------------------------------

### Edit Wiki Page

Source: https://whoami.wiki/docs/cli

Edits a wiki page using find-and-replace. Specify the text to find with --old and the replacement with --new. Use --replace-all to change all occurrences or --dry-run to preview.

```bash
wai edit "Summer 2023" --old "old text" --new "new text"
```

```bash
wai edit "Summer 2023" --old "typo" --new "fixed" --replace-all
```

```bash
wai edit "Summer 2023" --old "old" --new "new" --dry-run
```

--------------------------------

### Cite Video Template

Source: https://whoami.wiki/docs/citation-system

Template for citing video content.

```mediawiki
{{Cite video|file=berlin_gallery_opening.mp4|date=2021-11-12
|snapshot=a1b2c3d4e5f6|note=Gallery opening footage}}
```

--------------------------------

### Research Notes - Research Slices

Source: https://whoami.wiki/docs/namespaces

This section indexes research materials, specifying the slice name, its file path, and which pages or sections consumed it.

```wiki
=== Research slices ===
* Slice A (Mar 1-15): /tmp/jane_slice_a.md — consumed by
  [[Jane Doe]], [[Jane and the Tempelhof Disaster]]
* Slice B (Mar 16-31): /tmp/jane_slice_b.md — consumed by [[Jane Doe]]
```

--------------------------------

### Main Namespace Pages

Source: https://whoami.wiki/docs/namespaces

Pages in the Main namespace, such as person and episode pages, do not have a prefix.

```text
Jane Doe
Jane and the Tempelhof Disaster
```

--------------------------------

### Reuse Named Refs

Source: https://whoami.wiki/docs/citation-system

Use named refs to cite the same source multiple times within a page.

```mediawiki
Jane's mother is from Munich.<ref name="ig-2021-04-15" />
Her father works in Zurich.<ref name="ig-2021-05-02">
{{Cite message|snapshot=a1b2c3d4e5f6|date=2021-05-02
|thread=janedoe_12345|note=Family details, father in Zurich}}</ref>
She has a younger brother named Max.<ref name="ig-2021-04-15" />
```

--------------------------------

### Inline Citation with Ref Tag

Source: https://whoami.wiki/docs/citation-system

Standard MediaWiki ref tag usage for inline citations pointing to a specific vault snapshot.

```mediawiki
Jane was born in Munich and moved to Berlin at eighteen.<ref name="ig-2021-04-15">
{{Cite message|snapshot=a1b2c3d4e5f6|date=2021-04-15
|thread=janedoe_12345|note=Family background exchange}}</ref>
```

--------------------------------

### Read Talk Page

Source: https://whoami.wiki/docs/cli

Reads a page's talk page. Use --thread to read a specific discussion thread or --raw for unformatted output.

```bash
wai talk read "Summer 2023"
```

```bash
wai talk read "Summer 2023" --thread "Location details"
```

```bash
wai talk read "Summer 2023" --raw
```

--------------------------------

### Infrastructure Section in Talk Pages

Source: https://whoami.wiki/docs/namespaces

This section uses the '{{Closed}}' template to document technical issues and their resolutions, such as file upload problems.

```wiki
=== Audio upload blocked ===
{{Closed}}
.mp4 not in $wgFileExtensions. Fixed by adding mp4 to LocalSettings.php.
```

--------------------------------

### Snapshot Instagram Export

Source: https://whoami.wiki/docs/writing-your-first-page

Use this command to snapshot your Instagram export data. Ensure the path to your export is correctly specified.

```bash
Snapshot my Instagram export at ~/Downloads/instagram-export
```

--------------------------------

### Talk Namespace Pages

Source: https://whoami.wiki/docs/namespaces

Pages in the Talk namespace appear with the 'Talk:' prefix, used for documentation and editorial processes.

```text
Talk:Jane Doe
Talk:Jane and the Tempelhof Disaster
```

--------------------------------

### Claim a task

Source: https://whoami.wiki/docs/cli

Use `wai task claim` with a task ID to claim a pending task for processing.

```bash
wai task claim <id>

```

--------------------------------

### Cite Voice Note Template

Source: https://whoami.wiki/docs/citation-system

Template for citing voice note content from the archive.

```mediawiki
{{Cite voice note|number=7|date=2021-06-03|speaker=Jane
|snapshot=a1b2c3d4e5f6|note=Darkroom discovery story}}
```

--------------------------------

### Complete a task

Source: https://whoami.wiki/docs/cli

Mark an in-progress task as completed using `wai task complete` and the task ID. An optional message can be provided to record details about the completion.

```bash
wai task complete <id>

```

```bash
wai task complete <id> -m "Created 3 new pages"

```

--------------------------------

### wai edit

Source: https://whoami.wiki/docs/cli

Performs a find-and-replace operation on a wiki page.

```APIDOC
## wai edit

### Description
Edit a page using find-and-replace.

### Parameters
#### Path Parameters
- **title** (string) - Required - The title of the page to edit.

#### Flags
- **--old** (string) - Required - Text to find.
- **--new** (string) - Required - Replacement text.
- **--replace-all** (boolean) - Optional - Replace all occurrences.
- **--dry-run** (boolean) - Optional - Preview changes without applying.
- **-m, --summary** (string) - Optional - Edit summary.
```

--------------------------------

### Cite Vault Template

Source: https://whoami.wiki/docs/citation-system

Template for the Bibliography section to describe a full vault snapshot consulted.

```mediawiki
{{Cite vault|type=messages|snapshot=a1b2c3d4e5f6
|timestamp=2021-03-01/2022-05-15|note=Instagram DM thread with Jane Doe}}
```

--------------------------------

### Cite Photo Template

Source: https://whoami.wiki/docs/citation-system

Template for citing facts derived from photos or screenshots.

```mediawiki
{{Cite photo|file=IMG_2847.jpg|hash=...|date=2021-05-20
|snapshot=a1b2c3d4e5f6|note=University ID confirming enrollment}}
```

--------------------------------

### Draft Person Page for Alex

Source: https://whoami.wiki/docs/writing-your-first-page

Initiate the drafting of a Person page for 'Alex' using data extracted from the Instagram source. The agent will create an infobox, sections, citations, and media.

```bash
Write a Person page for Alex from the Instagram data.
```

--------------------------------

### wai read

Source: https://whoami.wiki/docs/cli

Reads the content of a specific wiki page.

```APIDOC
## wai read

### Description
Read a wiki page.

### Parameters
#### Path Parameters
- **title** (string) - Required - The title of the page to read.

#### Flags
- **-s, --section** (number) - Optional - Read only section number n.
- **--offset** (number) - Optional - Start output from line n.
- **-n, --limit** (number) - Optional - Limit output to n lines.
- **--raw** (boolean) - Optional - Output raw wikitext without formatting.
```

--------------------------------

### Requeue a task

Source: https://whoami.wiki/docs/cli

The `wai task requeue` command moves a failed or in-progress task back to the pending queue.

```bash
wai task requeue <id>

```

--------------------------------

### Cite Message Template

Source: https://whoami.wiki/docs/citation-system

Template for citing text message content such as DMs or chat logs.

```mediawiki
{{Cite message|snapshot=a1b2c3d4e5f6|date=2021-04-15
|thread=janedoe_12345|note=Family background exchange}}
```

--------------------------------

### Agent Log Entries in Talk Pages

Source: https://whoami.wiki/docs/namespaces

Each entry in the agent log details a task that modified the page, including the task ID, date, changes made, and a link to the task.

```wiki
=== Task:0008 — Initial page creation ===
2026-02-15. Created page from Instagram DM research (6,200 messages).
Posted 3 open gaps. See [[Task:0008]].

=== Task:0012 — Full enrichment ===
2026-02-16. Rewrote page from 80 to 350 lines. Integrated all research
slices, voice note transcriptions, photo analyses. See [[Task:0012]].
```

--------------------------------

### wai place

Source: https://whoami.wiki/docs/cli

Look up a place using the Google Places API.

```APIDOC
## GET wai place

### Description
Look up a place using the Google Places API. Requires GOOGLE_PLACES_API_KEY environment variable or config file entry.

### Method
GET

### Endpoint
wai place <query>

### Parameters
#### Query Parameters
- **query** (string) - Required - The search term for the place.
- **--limit** (number) - Optional - Maximum number of results (default: 5).
```

--------------------------------

### Update Specific Section

Source: https://whoami.wiki/docs/cli

Updates a specific section of a wiki page. Content can be provided inline (-c) or from a file (-f). An edit summary can be added with -m.

```bash
wai section update "Summer 2023" 2 -c "New section content"
```

```bash
wai section update "Summer 2023" 2 -f section.txt -m "Update section"
```

--------------------------------

### Fail a task

Source: https://whoami.wiki/docs/cli

Use `wai task fail` with a task ID to mark an in-progress task as failed. An optional message can be provided to record the reason for failure.

```bash
wai task fail <id>

```

```bash
wai task fail <id> -m "Missing location data"

```

--------------------------------

### Survey Instagram Source

Source: https://whoami.wiki/docs/writing-your-first-page

Survey the data from a previously snapshotted Instagram source to assess its content and identify potential gaps or quality issues.

```bash
Survey the Instagram source I just snapshotted.
```

--------------------------------

### Research Notes - Photo Analysis

Source: https://whoami.wiki/docs/namespaces

This subsection provides a count of cataloged photos and a summary of their analysis.

```wiki
=== Photo analysis ===
22 photos catalogued. Summary at /tmp/jane_photos.md.
```

--------------------------------

### wai search

Source: https://whoami.wiki/docs/cli

Performs a full-text search across all wiki pages.

```APIDOC
## wai search

### Description
Full-text search across all pages.

### Parameters
#### Path Parameters
- **query** (string) - Required - The search term.

#### Flags
- **-n, --limit** (number) - Optional - Maximum number of results (default: 10).
```

--------------------------------

### Active Gaps Section in Talk Pages

Source: https://whoami.wiki/docs/namespaces

This section uses the '{{Open}}' template to mark and describe open editorial questions that require resolution.

```wiki
=== Birth year unknown ===
{{Open}}
Likely 1996-1998 based on contextual clues (completed BA, gap year
in late 2019). Never stated directly in DMs. Would require external
source to confirm.
```

--------------------------------

### Final Editorial Review

Source: https://whoami.wiki/docs/writing-your-first-page

Perform a final editorial review of the page to audit tone, balance, and completeness. This ensures all factual claims are cited and produces a citation manifest.

```bash
Do a final editorial review of the Alex page.
```

--------------------------------

### Add Personal Memories

Source: https://whoami.wiki/docs/writing-your-first-page

Integrate personal memories and anecdotes into the page. The agent will incorporate your testimony and note any conflicts with the digital record on the Talk page.

```markdown
Some memories about Alex:
- We got lost finding the restaurant and walked through a park
  where Alex spent ten minutes befriending a stray cat.
- At the concert someone behind us sang off-key and Alex couldn't
  stop laughing. We moved seats twice.
- We actually met on a Friday, not Thursday. I'd just finished
  my last class of the week.

```

--------------------------------

### Calculate Composite Score

Source: https://whoami.wiki/docs/evals-suite

This formula calculates a composite score by weighting quality, content, and mechanics. Ensure all component scores are available before applying.

```python
page_composite = 0.5 * quality + 0.3 * content + 0.2 * mechanics

```

--------------------------------

### Resolved Section in Talk Pages

Source: https://whoami.wiki/docs/namespaces

This section uses '{{Closed}}' and '{{Superseded}}' templates to track resolved and previously resolved editorial questions.

```wiki
=== Did they meet in person? ===
{{Superseded}}
Previously resolved as one meeting (dinner, Nov 12).

{{Closed}}
Three meetings confirmed via WhatsApp thread (snapshot 3f0390a3...):
dinner (Nov 12), gallery opening (Nov 13), darkroom session (Nov 14).
```
Tokens:
Raw