daily-update

Original：🇺🇸 English

Translated

Run the daily wiki maintenance cycle: check all source freshness, update the index, and regenerate hot.md. Use this skill when the user says "/daily-update", "run the daily update", "update everything", "morning sync", "refresh the wiki index", or when triggered by the launchd cron at 9 AM. Also use to set up or verify the cron + terminal notification infrastructure for the first time ("set up the daily cron", "install the terminal notification", "how do I get the morning reminder?").

5installs

Sourcear9av/obsidian-wiki

Added on2026-05-05

NPX Install

npx skill4agent add ar9av/obsidian-wiki daily-update

SKILL.md Content

View Translation Comparison →

Daily Update — Wiki Maintenance Cycle

You run a lightweight maintenance pass over the wiki: check source freshness, refresh the index, update hot.md, and write the state file that the terminal notification reads.

Before You Start

Read

~/.obsidian-wiki/config

to get

OBSIDIAN_VAULT_PATH

and

OBSIDIAN_WIKI_REPO

.

Read
```
$OBSIDIAN_VAULT_PATH/.manifest.json
```
.

Modes

Run Mode (default — triggered by cron or

/daily-update

)

Execute the maintenance cycle:

Step 1: Source freshness check

Compare each source in

.manifest.json

against its file's modification time. Classify as:

Fresh —
```
mtime ≤ ingested_at
```
Stale —
```
mtime > ingested_at
```
(new content exists, not yet ingested)
Missing — source file no longer exists

Step 2: Index refresh

Read

$OBSIDIAN_VAULT_PATH/index.md

. If any pages in the vault are missing from the index (or vice versa), update the index. Use

find $OBSIDIAN_VAULT_PATH -name "*.md" -not -path "*/_*"

to enumerate vault pages, then reconcile against the index.

Step 3: hot.md update

Read

hot.md

. If it's >48h old based on its

updated:

frontmatter, regenerate it: read the 10 most recently modified wiki pages and write a fresh ~500-word semantic snapshot of what the wiki covers. This keeps the next session's context warm without a full vault crawl.

Step 4: Write state

bash

mkdir -p ~/.obsidian-wiki
date +%s > ~/.obsidian-wiki/.last_update
echo "<stale_count>" > ~/.obsidian-wiki/.pending_delta

Step 5: Spawn impl-validator

After the cycle, spawn

impl-validator

as a subagent:

impl-validator check:
  goal: "Daily wiki maintenance — index reconciled, hot.md refreshed, state file written"
  artifacts:
    - $OBSIDIAN_VAULT_PATH/index.md
    - $OBSIDIAN_VAULT_PATH/hot.md
    - ~/.obsidian-wiki/.last_update
    - ~/.obsidian-wiki/.pending_delta
  checks:
    - Does .last_update contain a recent Unix timestamp (within the last 60 seconds)?
    - Does .pending_delta contain a non-negative integer?
    - Does hot.md have an updated: frontmatter field set to today?
    - Does index.md list at least as many pages as exist in the vault?

Apply any FAILs before logging.

Step 6: Log

Append to

$OBSIDIAN_VAULT_PATH/log.md

:

- [TIMESTAMP] DAILY-UPDATE fresh=N stale=N missing=N index_added=N hot_refreshed=true|false

Step 7: Report to user

## Daily Wiki Update

- Sources: N fresh · N stale · N missing
- Index: N pages (N added, N removed)
- hot.md: refreshed / up to date

Stale sources (run to sync):
  /wiki-history-ingest claude   — N sessions since last ingest
  /wiki-history-ingest codex    — N sessions since last ingest

Setup Mode (triggered by "set up the daily cron" or "install terminal notification")

Walk the user through first-time setup:

Step 1: Verify script exists

Check that

$OBSIDIAN_WIKI_REPO/scripts/daily-update.sh

exists and is executable. If not, point the user to it.

Step 2: Install launchd plist

bash

# Replace placeholder in plist
sed "s|OBSIDIAN_WIKI_REPO|$OBSIDIAN_WIKI_REPO|g" \
  "$OBSIDIAN_WIKI_REPO/scripts/com.obsidian-wiki.daily-update.plist" \
  > "$HOME/Library/LaunchAgents/com.obsidian-wiki.daily-update.plist"

# Load it
launchctl load "$HOME/Library/LaunchAgents/com.obsidian-wiki.daily-update.plist"

Step 3: Install terminal notification

Check if

~/.zshrc

already sources

wiki-notify.sh

. If not, append:

bash

echo "" >> ~/.zshrc
echo "# obsidian-wiki terminal notification" >> ~/.zshrc
echo "source $OBSIDIAN_WIKI_REPO/scripts/wiki-notify.sh" >> ~/.zshrc

Step 4: Run the script once

bash

bash "$OBSIDIAN_WIKI_REPO/scripts/daily-update.sh"

This initializes

~/.obsidian-wiki/.last_update

so the terminal notification works immediately.

Step 5: Confirm

Tell the user:

The cron runs daily at 9 AM (or on next login if missed)
Terminal notifications appear when the wiki is >20 hours stale
They can run
```
/daily-update
```
anytime to force a sync
Logs go to
```
/tmp/obsidian-wiki-daily.log
```

daily-update

NPX Install

Tags

SKILL.md Content

Daily Update — Wiki Maintenance Cycle

Before You Start

Modes

Run Mode (default — triggered by cron or
`/daily-update`
)

Setup Mode (triggered by "set up the daily cron" or "install terminal notification")

daily-update

NPX Install

Tags

SKILL.md Content

Daily Update — Wiki Maintenance Cycle

Before You Start

Modes

Run Mode (default — triggered by cron or /daily-update)

Setup Mode (triggered by "set up the daily cron" or "install terminal notification")

Run Mode (default — triggered by cron or
`/daily-update`
)