Getting started / Install & sign in

Install & sign in

suisuinian is an asynchronous work system. Start on macOS — the iOS apps join in via iCloud on their own. On first run you pick a place for your vault (the store for your fragments); iPhone clients hook up once they sign into the same iCloud account.

# Install the CLI via Homebrew tap
$ brew install suisuinian/tap/cli

# Create the vault wherever you like
$ suisuinian init ~/vault

# Launch the background daemon · watches iCloud Drive for changes
$ suisuinian daemon start

The first time the daemon starts, macOS will ask for iCloud authorization and Full Disk Access — both are needed for the vault to sync between iCloud Drive and your local disk.

Integrations / MCP

Connect Claude (MCP)

Install a small standalone helper and Claude for Mac can read your vault: pull up meeting transcripts, rewrite minutes, check your vocabulary book, write diary entries. It is a separate command-line program that Claude launches on demand — it does not need the suisuinian Mac app running, and its data source is the suisuinian folder in iCloud Drive.

Two things to check first

Claude for Mac is installed on this machine (claude.ai/download) and has been opened at least once.
suisuinian on your iPhone has iCloud on, and this Mac is signed into the same Apple ID — open Finder → iCloud Drive and you should see a suisuinian folder.

Three steps

Download the helper package (400 KB · notarized by Apple · universal, Intel and Apple silicon).
Double-click it and keep clicking Continue → Install. No password needed — it installs into your user folder and touches nothing system-wide.
Quit Claude for Mac completely with ⌘Q, then open it again. Closing the window is not enough; it keeps running with the old config in the background.

The first time Claude uses it, it will ask whether it may read suisuinian — allow it. If it says it cannot find your vault, iCloud has not finished syncing yet; wait a little, no need to reinstall.

Once installed, just ask

What did my meetings last week cover?
Rewrite the minutes from Aug 19 — decisions in one part, to-dos in the other
Which words should I review today?
Save this as a diary entry: …

The 8 tools

Tool	What it does	Read / write
vault_search	Search everything: titles, summaries, tags, people, projects. The starting point	read
recording_list	List every recording and whether its transcript has landed	read
recording_transcript	Read the full transcript of one recording (raw ASR, not an AI summary)	read
minutes_read	Read one entry's minutes, card summary and structured metadata	read
vocab_list	Your vocabulary book: word, phonetics, meaning, examples, review progress, where you met it	read
report_daily	Read a given day's report: summary, key insights, stats	read
minutes_write	Rewrite the minutes of an entry; the previous version is archived	write
diary_write	Add a new text entry to the timeline	write

The two write tools only drop product files; changes show up in the timeline after the Mac app's next scan, about 30 seconds later. Two known limits: transcripts currently carry no speaker labels or timestamps — searching the content is fine, "who said this" is not answerable — and the vocabulary book is read-only in this version.

What it will not do

It will not delete anything — there is no delete tool at all.
It will not send your data anywhere — it reads one iCloud folder on this Mac and never goes online.
It never touches Dashboard.json (the timeline index). Worst case is one wrong file, not a lost timeline.
When it rewrites minutes, the old version is kept in core/meta/minutes-history/, so a bad edit is recoverable.
It leaves your existing Claude settings alone — it only adds one entry to the config.

Developers: wiring up other hosts

The helper is an MCP server over stdio, so any MCP host can launch it. One command for Claude Code:

# register at user scope, available in every project
$ claude mcp add --scope user suisuinian -- \
    "$HOME/Library/Application Support/suisuinian/suisuinian-mcp"

# MCP servers load at session start — open a new session for it to take effect
$ claude mcp get suisuinian

Hand-written config for other hosts (the package already writes this one for Claude for Mac; keep it for reference or repair):

{
  "mcpServers": {
    "suisuinian": {
      "command": "/Users/YOUR_NAME/Library/Application Support/suisuinian/suisuinian-mcp"
    }
  }
}

The vault is located in iCloud Drive automatically. If yours lives elsewhere, pass --vault /path/to/vault or set SUISUINIAN_VAULT.

Uninstalling

In Finder press ⌘⇧G, enter ~/Library/Application Support/suisuinian and delete that folder.
Open Claude and tell it to remove suisuinian from the config.