From wayfind
Initialize Wayfind for a non-repo folder (e.g., ~/admin, ~/). Creates .claude/personal-state.md, defensively updates .gitignore if one exists, and registers the folder in the global index. Safe to run multiple times (idempotent).
How this skill is triggered — by the user, by Claude, or both
Slash command
/wayfind:init-folderThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run these steps in order. Skip any step that's already done (this command is idempotent).
Run these steps in order. Skip any step that's already done (this command is idempotent).
This command is for non-repo working directories — your home directory, an admin folder,
a scratch workspace, etc. For git repos, use /wayfind:init-memory instead.
git rev-parse --show-toplevel 2>/dev/null)
/wayfind:init-memory instead? That sets up team-state.md for shared context too."~/.claude/global-state.md to check if this folder is already registeredNon-repo folders only get one state file — there's no team-state.md because there's no git repo to commit it to.
If .claude/personal-state.md does not exist, create it:
# [Folder Name] — Personal State
Last updated: [today's date]
(This file is local-only. It persists context across AI sessions in this folder.)
## My Current Focus
<!-- Your current tasks and next steps for work in this folder -->
## Personal Context
<!-- Working notes, decisions, things to remember -->
## What I'm Watching
<!-- Open questions, things to follow up on -->
Create the .claude/ directory first if it doesn't exist.
Check if a .gitignore file exists in the folder root.
If .gitignore exists: Ensure .claude/ is listed (the whole directory — unlike repos,
non-repo folders have no team-state.md to preserve). If it's missing, append it.
If .gitignore does not exist: Skip this step. Don't create one — this isn't a repo.
Read the folder's CLAUDE.md (if it exists).
If it exists and does NOT contain "Session State Protocol": Note to the user:
"Your ~/CLAUDE.md (or global instructions) should include the session protocol.
If you're using Wayfind's standard ~/CLAUDE.md, you're already covered."
If it exists and DOES contain "Session State Protocol": Skip — already configured.
If it does not exist: Do NOT create one. Note: "No CLAUDE.md in this folder.
Your ~/CLAUDE.md global instructions handle the session protocol."
Read ~/.claude/global-state.md. Add the folder's state file to the State Files table
if missing:
| `[full path]/.claude/personal-state.md` | Personal context for [folder name] (non-repo) |
The Active Projects table is auto-generated by wayfind status --write — do NOT add
rows to it manually.
Tell the user:
.claude/personal-state.md — created or already existed (local only).gitignore — updated or not applicableglobal-state.md — folder registered or already listedThen print:
"This folder is now tracked by Wayfind. Context saved here will be available in future
sessions. For cross-repo context that should be available everywhere, save to
~/.claude/memory/ instead."
npx claudepluginhub usewayfind/wayfind --plugin wayfindScaffolds Total Recall memory system: creates memory/registers (people, projects etc.), daily/archive dirs, SCHEMA.md, CLAUDE.local.md working memory, and .gitignore entry.
Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.