Tool Commands

bm tool write-note --title TITLE --folder FOLDER [OPTIONS]

# Write note with content
bm tool write-note --title "My Note" --folder "notes" --content "Note content"

# Write from stdin
echo "content" | bm tool write-note --title "My Note" --folder "notes"

# Write with tags
bm tool write-note --title "My Note" --folder "notes" --content "Content" --tags python --tags async

# Force local routing
bm tool write-note --title "My Note" --folder "notes" --content "Content" --local

{
  "path": "notes/my-note.md",
  "title": "My Note",
  "permalink": "my-note",
  "message": "Note created successfully"
}

bm tool read-note IDENTIFIER [OPTIONS]

# Read by title
bm tool read-note my-note

# Read with frontmatter
bm tool read-note my-note --include-frontmatter

# Read with pagination
bm tool read-note my-note --page 2 --page-size 5

# Read from specific project
bm tool read-note my-note --project research

{
  "identifier": "my-note",
  "title": "My Note",
  "content": "# My Note\n\nNote content here...",
  "path": "notes/my-note.md",
  "page": 1,
  "total_pages": 1
}

bm tool edit-note IDENTIFIER --operation OPERATION --content CONTENT [OPTIONS]

# Append content
bm tool edit-note my-note --operation append --content "new content"

# Prepend content
bm tool edit-note my-note --operation prepend --content "intro text"

# Find and replace
bm tool edit-note my-note --operation find_replace --find-text "old" --content "new"

# Replace section
bm tool edit-note my-note --operation replace_section --section "## Notes" --content "updated"

{
  "path": "notes/my-note.md",
  "message": "Note updated successfully",
  "operation": "append"
}

bm tool search-notes [QUERY] [OPTIONS]

# Full-text search
bm tool search-notes "python async"

# Search by permalink
bm tool search-notes --permalink "specs/*"

# Search by title
bm tool search-notes --title "meeting"

# Filter by tags
bm tool search-notes --tag python --tag async

# Filter by metadata
bm tool search-notes --meta status=draft

# Recent items
bm tool search-notes --after_date 7d

# Combine filters
bm tool search-notes "async" --tag python --after_date 1w

# Vector search
bm tool search-notes "semantic similarity" --vector

# Hybrid search
bm tool search-notes "query" --hybrid

{
  "query": "python async",
  "results": [
    {
      "title": "Async Programming",
      "permalink": "async-programming",
      "path": "notes/async-programming.md",
      "snippet": "...Python async programming with asyncio...",
      "score": 0.95
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 10
}

bm tool build-context URL [OPTIONS]

# Build context
bm tool build-context memory://specs/search

# Build with depth
bm tool build-context specs/search --depth 2

# Build with timeframe
bm tool build-context specs/search --timeframe 30d

# Build with limits
bm tool build-context specs/search --max-related 5

{
  "url": "memory://specs/search",
  "entity": {
    "title": "Search Specification",
    "content": "..."
  },
  "related": [
    {
      "title": "Search Implementation",
      "relation": "implements"
    }
  ],
  "recent_changes": [
    {
      "title": "Search Updates",
      "updated": "2024-01-15T14:30:00Z"
    }
  ]
}

bm tool recent-activity [OPTIONS]

# Recent activity
bm tool recent-activity

# Last 30 days
bm tool recent-activity --timeframe 30d

# Filter by type
bm tool recent-activity --type entity --type observation

# More results
bm tool recent-activity --page-size 100

{
  "timeframe": "7d",
  "items": [
    {
      "title": "Meeting Notes",
      "type": "entity",
      "updated": "2024-01-15T14:30:00Z",
      "path": "notes/meeting-2024-01-15.md"
    }
  ],
  "total": 1,
  "page": 1
}

bm tool list-projects [OPTIONS]

# List projects
bm tool list-projects

# List local projects only
bm tool list-projects --local

{
  "projects": [
    {
      "name": "research",
      "path": "~/Documents/research",
      "is_default": true
    }
  ]
}

bm tool list-workspaces [OPTIONS]

# List workspaces
bm tool list-workspaces

# Force cloud routing
bm tool list-workspaces --cloud

{
  "workspaces": [
    {
      "name": "Personal",
      "tenant_id": "11111111-2222-3333-4444-555555555555",
      "workspace_type": "personal"
    }
  ]
}

bm tool schema-validate [TARGET] [OPTIONS]

# Validate all notes
bm tool schema-validate

# Validate by type
bm tool schema-validate person

# Validate specific note
bm tool schema-validate people/ada-lovelace.md

{
  "valid": true,
  "errors": [],
  "notes_validated": 5
}

bm tool schema-infer NOTE_TYPE [OPTIONS]

# Infer schema
bm tool schema-infer person

# With threshold
bm tool schema-infer meeting --threshold 0.5

{
  "note_type": "person",
  "schema": {
    "required": ["name"],
    "optional": ["email", "role"]
  },
  "sample_count": 10
}

bm tool schema-diff NOTE_TYPE [OPTIONS]

# Check drift
bm tool schema-diff person

# Check in specific project
bm tool schema-diff person --project research

{
  "note_type": "person",
  "missing_fields": ["phone"],
  "extra_fields": ["twitter"],
  "notes_analyzed": 10
}

# Pipe to jq for filtering
bm tool search-notes "query" | jq '.results[0].title'

# Save to file
bm tool list-projects > projects.json

# Use in scripts
TITLE=$(bm tool read-note my-note | jq -r '.title')
echo "Note title: $TITLE"

{
  "error": "Note not found: invalid-note"
}

if bm tool read-note my-note; then
  echo "Success"
else
  echo "Failed"
fi