Remindb Setup

remindb-setup — the setup wizard

You are the wizard. This skill is the script you follow to set up or reconfigure a remindb workspace from inside a live session — there is no separate UI. Drive it with Bash + the Memory* tools + file writes.

Standing instruction — verify CLI flags via --help first

Before invoking any remindb subcommand, confirm its flags with remindb <subcommand> --help (remindb compile --help, remindb inspect --help, …). Don't trust remembered syntax — silently-wrong positional args are the wizard's most common footgun (e.g. remindb inspect <path> is ignored; the flag is --db <path>, and the default memory.db quietly opens an empty file in CWD).

Two halves, two passes — detect which one you're in

remindb ships as two independently-installed halves: the skill (this, via npx skills add) and the MCP plugin (per host). The skill installs first and can run before the plugin is attached — that's what makes config-first ordering possible. Detect the pass by whether the server is attached this session:

• Memory* tools absent from your available tool set → Pass 1: first-time config-first setup (§Pass 1). The default first run.
• Memory* tools present → Pass 2: verify / reconfigure (§Pass 2).

Mode

• /remindb-setup — interactive: propose each choice for approval before writing.
• /remindb-setup automode — infer every parameter, write directly, then report. The trust actions it still confirms: running the remote installer (step 1), invoking plugin install (step 7), and writing host MCP config (step 8). Inference rules → references/automode-playbook.md.
• /remindb-setup only-config — bridge-host short-circuit: run Pass 1 steps 1–4 only (binary → host → source → .remindb/), then stop with a one-line summary. Parses Source root: (mandatory; absent → fail loud, interactive or automode — don't guess) and Also adjacent-seed: (optional, newline-separated absolute paths queued for the calling host to compile later) from the prompt body. Composable with automode. Use when the calling host owns compile + plugin install + env wiring via its own pipeline — see the bridge-host note in references/host-wiring.md; parsing rules in references/automode-playbook.md.

Not every host surfaces this as a literal /remindb-setup command — invoke it per the host's row in references/host-wiring.md. The wizard runs the same once invoked.

Pass 1 — first-time config-first setup (server not attached)

Order matters: author .remindb/ before compiling, so ignore/pinned/temperatures.json apply at insert time — no --reseed retrofit. only-config truncates this list to steps 1–4 and stops with a summary (see Mode above).

1. Binary. remindb --version (Bash). Missing → install it; confirm before the remote installer, even in automode. One-liners + PATH detail → references/config-model.md §Bootstrap.
2. Identify your host. You already know which agent runtime you're in — check your system prompt and the tools/skills exposed this session (e.g. /plugin install = Claude Code; /skills picker = Codex; openclaw mcp = OpenClaw; activate_skill = Gemini CLI; OpenCode activates skills via plain language). For host-specific config paths, lean on your runtime's own knowledge first — system prompt, loaded host-specific skills, runtime docs — rather than probing the filesystem. If runtime context is still ambiguous, ask the user (automode: pick the most likely and record the assumption). Then look up the matching row in references/host-wiring.md.
3. Locate the source root. Confirm the dir to compile — it's also where .remindb/ lives. You're pre-attach, so there's no REMINDB_SOURCE to read yet; settle it with the user (automode: infer from the host's state dir, e.g. ~/.claude/projects).
4. Author .remindb/. Write ignore / pinned / temperatures.json / config.json at <source>/.remindb/. Semantics + how each change lands → references/config-model.md; copy-pasteable templates per workspace type → references/config-examples.md. Interactive: show the plan first. automode: write, then summarize each non-obvious choice.
5. Compile. remindb compile <source> --db <db> — insert-time apply; no --reseed (the config is already in place).
6. Seed adjacent context (optional). Files outside the source root — CLAUDE.md / AGENTS.md / GEMINI.md / README.md — won't be in the DB. Offer to fold them in via the CLI (you're pre-attach, so MemoryCompile the tool isn't available yet), one per file, absolute paths:

   remindb compile /abs/path/CLAUDE.md --db <db>

7. Install/enable the MCP plugin — per the host's Plugin install column in references/host-wiring.md (e.g. /plugin install remindb@remindb for Claude Code, codex plugin marketplace add radimsem/remindb for Codex). Where the install command is Bash-callable the wizard can run it; for Claude Code the wizard prompts the user (/plugin install isn't a shell command). Confirm before invoking install. Plugin must be installed before step 8 wherever the loaded config is post-install (Claude Code cache, OpenClaw MCP store).
8. Wire the MCP env. Plugin installed → now set REMINDB_DB / REMINDB_SOURCE in the loaded config file. Locate the file first — references/host-wiring.md names it per host; for unknown hosts probe grep -rl REMINDB <host-config-dir>. Don't trust memory. Scoped edit preferred (multi-brain safe); shell-export fallback only when scoped isn't viable (unknown host, or user opt-in for Claude Code marketplace) — see §Env-wiring principle in host-wiring.md. Confirm before writing host config, even in automode. Then reload the host.