From valis
Bulk-import a folder of markdown documentation as decisions (drafts queue for unprefixed files).
How this command is triggered — by the user, by Claude, or both
Slash command
/valis:index <folder> (e.g. ./docs or ./specs)The summary Claude sees in its command listing — used to decide when to auto-load this command
Take an existing tree of markdown files and seed Valis with their content in one shot, instead of typing each decision via `/valis:store`. Files with a recognized prefix (`decision-`, `pattern-`, `constraint-`, `lesson-`, `postmortem-`) are stored as `active` with the inferred type. Files without a prefix are stored as `proposed` drafts so you can triage them in the dashboard before they enter the active set. ## Steps 1. Resolve the target folder from `$ARGUMENTS`. - If empty, ask: "Which folder should I index? (e.g. ./docs, ./specs)" - If the value is a relative path, resolve it ag...
Take an existing tree of markdown files and seed Valis with their content in one shot, instead of typing each decision via /valis:store. Files with a recognized prefix (decision-, pattern-, constraint-, lesson-, postmortem-) are stored as active with the inferred type. Files without a prefix are stored as proposed drafts so you can triage them in the dashboard before they enter the active set.
Resolve the target folder from $ARGUMENTS.
$CLAUDE_PROJECT_DIR if that env var is set; otherwise against the current working directory.Detect whether the local valis CLI is available:
valis --version
0.1.3 or higher, prefer the CLI path (step 3) — it streams progress, uses the same chunking + e5-small embedding pipeline as valis_store, and applies all the heuristic + status logic in one place.valis_store calls — this is slower but produces the same result. Install the CLI for faster bulk imports: npm i -g valis-cli@latest."CLI path — shell out:
valis index <folder> --strategy section --use-git --yes (section-split + git author/date + skip the per-question prompts).$ARGUMENTS already contains flags (e.g. they typed ./specs --strategy file), forward them verbatim instead of using the defaults.Plugin-native path — run when CLI is absent. This path takes longer (one MCP call per file) so confirm with the user first:
Glob to enumerate **/*.md and **/*.markdown under the folder (respect .gitignore — do not descend into node_modules, dist, or dot-prefixed dirs).decision-* → decision, pattern-* → pattern, constraint-* → constraint, lesson-* / postmortem-* → lesson, otherwise decision + flag as draft.# ) as the summary; truncate to 100 chars. If no H1, use the filename without extension.valis_check_duplicate with the first 1000 chars of the body. If a result with similarity ≥ 0.85 already exists, skip the file and add it to a skipped_dupes[] list.valis_store with: text (full body), type (inferred), summary (extracted), affects (empty unless the user passed a tag prefix in $ARGUMENTS), status ('active' if prefix matched, 'proposed' otherwise).After either path completes, if any proposed drafts were created, suggest:
Drafts are awaiting your review. Open the dashboard ({org}.krukit.co/projects/{project}/proposals) or run
/valis:lifecycle promote <id>per draft.
--resume-from, batch rollback, similarity-based pre-import audit. For now if any of those matter, point the user at the CLI.npx claudepluginhub todmy/valis-plugin --plugin valis/indexGenerates project documentation, knowledge base, API docs, structure analysis, or README for a target path. Supports --type (docs|api|structure|readme) and --format (md|json|yaml).
/indexIndexes codebase into Supermemory for persistent context: detects tech ecosystem, scans manifests/configs/entry points/architecture.
/indexIndexes codebase components and external resources into searchable specs in `specs/.index/`. Supports --path, --type, --exclude, --dry-run, --force, --changed, --quick flags.
/indexGenerates project documentation (docs, API, structure, readme) and knowledge base for a target directory in MD, JSON, or YAML format with update option.
/indexGenerates AI-readable feature index mapping natural language descriptions of UI elements, interactions, and business flows to exact code locations and modification guides. Saves markdown report to .claude/context/index.md.
/indexDisplays visual dashboard of Beacon index: chunks, coverage, provider. Lists indexed files with --files. Adds one-line summary; suggests /reindex on failure.