Skip to content

tmd init

Initializes a new vault. Creates .typemd/ directory structure, SQLite database, and a .typemd/.gitignore that excludes index.db.

After creating the vault structure, an interactive starter type selector is displayed. Starter types are common type schemas (idea, note, book) that help you get started quickly. All are selected by default — use the keyboard to customize your selection:

  • ↑↓ or j/k — move cursor
  • Space — toggle selection
  • a — select all
  • n — deselect all
  • Enter — confirm selection
  • Esc — skip (select none)

Selected starter types are written as types/<name>/schema.yaml files, fully owned and editable.

Terminal window
tmd init
FlagDescription
--no-startersSkip the starter type selector (empty vault)
Terminal window
# Non-interactive: skip starter types
tmd init --no-starters

tmd init always creates .typemd/config.yaml with cli.default_type: page. The built-in page type serves as the default for quick object creation.

This enables tmd object create "Some Thought" without specifying a type. See tmd object create for details. To change the default type later, use tmd config set.

Running tmd init on an already-initialized vault will return an error.