# kbchat-vault-index

> Agent skill for indexing local vault/code workspace with incremental scans and code digests.

- Author: 1EchA
- Repository: 1EchA/Codex-KBChat
- Version: 20260124203049
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/1EchA/Codex-KBChat
- Web: https://mule.run/skillshub/@@1EchA/Codex-KBChat~kbchat-vault-index:20260124203049

---

---
name: kbchat-vault-index
description: Agent skill for indexing local vault/code workspace with incremental scans and code digests.
---

# KBChat Vault Index

Use when scanning local files for changes and building code digests into the knowledge base.

## Skill contract

- Inputs:
  - `~/CodexVault/.kb/code_monitor_config.json`
  - `~/CodexVault/.kb/code_monitor_state.json`
  - Root path from config (default `~/cursor`)
- Actions:
  - `vault.scan_changes` (incremental scan)
  - `vault.write_code_digest`
  - `vault.search_local` (optional local search snippets)
- Outputs:
  - Code digest markdown under `summaries/code/YYYY/`
  - Chat status + notification
- State:
  - `~/CodexVault/.kb/code_monitor_state.json`

## Workflow (nodes)

1) Load config/state → 2) Scan files (lookback days) → 3) Generate digest → 4) Persist state + notify

## Notes

- Skip binaries/oversized files; respect `max_*` limits.
- Use relative paths in digests.

## Key files

- `Sources/KBChatMenuBar/CodeMonitorEngine.swift`
- `Sources/KBChatMenuBar/ChatEngine.swift`
- `Sources/KBChatMenuBar/ChatViewModel.swift`
- `Sources/KBChatMenuBar/VaultStore.swift`