setup

Files (1)

• SKILL.md

SKILL.md (first lines)

# TwinMind Setup

Initialize a new TwinMind vault in the current working directory.

## Pre-flight Checks

Before proceeding, check for existing installations:

1. **TwinMind.md exists** → Warn: "TwinMind.md already exists in this directory. Overwrite?" Ask user to confirm or abort.
2. **Old-style `.claude/skills/tm-*` directories exist** → Warn: "Detected old-style TwinMind installation (.claude/skills/tm-*). This plugin-based setup is separate. Consider removing old files to avoid confusion."
3. **Vault directory already exists and contains files** → Warn: "Directory `<vault_dir>/` already exists with content. Setup will not overwrite existing vault data. Only missing structure files will be created."

If all checks pass or user confirms, proceed.

## Interactive Configuration

Ask the user for customization (or accept defaults):

1. **Vault directory name** — default: `vault`
2. **Locale** — default: `zh-TW`
3. **Domains** — default: empty list (AI creates as needed)

## Setup Steps

### Resolve Plugin Root

Setup needs the plugin's absolute path to copy templates from. Read `<cwd>/.claude/twinmind/config.json` with the Read tool and use its `pluginRoot` field as `<plugin-root>` in the steps below.

**Cold-start fallback**: if `<cwd>/.claude/twinmind/config.json` does not exist, the SessionStart hook has not run for this vault yet (TwinMind.md is required to trigger it). In that case:

1. Use the Write tool to create `<cwd>/TwinMind.md` with minimal frontmatter (just `vault_dir: vault\nvault_name: TwinMind\nlocale: zh-TW`).
2. Tell the user: "請執行 `exit` 退出 Claude Code，然後 `claude` 重新啟動 session (讓 SessionStart hook 寫入 plugin 路徑)，再次執行 `/setup` 完成餘下步驟。"
3. Stop.

### Copy and Customize

1. Copy `<plugin-root>/templates/TwinMind.md` to `<cwd>/TwinMind.md`.
2. Update frontmatter values based on user's choices (`vault_dir`, `locale`, `domains`).
3. Copy `<plugin-root>/templates/vault/` directory structure to `<cwd>/<vault_dir>/`:
   - Create all subdirectories: `System/`, `Cards/`, `Sources/`, `Atlas/`, `PARA/Inbox/`, `PARA/Actions/`, `PARA/Projects/`, `PARA/Archive/`, `PARA/Areas/`, `PARA/Tasks/`.
   - Copy initial files: `System/vault-index.json`, `Home.md`, `PARA/Dashboard.md`.
   - Skip directories/files that already exist.
4. Create `.gitignore` in `<cwd>` if not exists, listing both `.obsidian/` and `.claude/twinmind/` (the latter holds plugin-generated shims that regenerate on every session start).

## Completion

Report:

- Created TwinMind.md at project root
- Created vault structure at `<vault_dir>/`
- Next steps: "Open this directory in Obsidian to browse your vault. Start talking to Claude to capture knowledge!"

From VolderLu/TwinMind, MIT.

More from VolderLu/TwinMind