With tags

basic-memory tool write-note --title "React Patterns" --content "# Content here" --tags "react,patterns,frontend"

To specific folder

basic-memory tool write-note --title "Meeting Notes" --content "# Notes" --folder "meetings"

With specific project

basic-memory tool write-note --title "Project Notes" --content "# Notes" --project myproject


### Read a Note
```bash
# By identifier/permalink
basic-memory tool read-note "note-title"

# From specific project
basic-memory tool read-note "note-title" --project myproject

Search Memories

# Semantic search (query is positional)
basic-memory tool search-notes "your search query"

# Limit results
basic-memory tool search-notes "react hooks" --page-size 10

# Search by permalink
basic-memory tool search-notes "pattern" --permalink

# Search by title
basic-memory tool search-notes "meeting" --title

# Filter by date
basic-memory tool search-notes "feature" --after_date "7d"

# With specific project
basic-memory tool search-notes "authentication" --project myproject

Build Context for a Topic

# Get related notes for a URL/topic (URL is positional)
basic-memory tool build-context "memory://topic/authentication"

# With depth and timeframe
basic-memory tool build-context "memory://note/my-note" --depth 2 --timeframe 30d

# With specific project
basic-memory tool build-context "memory://topic/api" --project myproject

List Recent Activity

# Default (depth 1, 7 days)
basic-memory tool recent-activity

# With depth
basic-memory tool recent-activity --depth 3

# With timeframe
basic-memory tool recent-activity --timeframe 30d

# Combined
basic-memory tool recent-activity --depth 3 --timeframe 14d

Continue Conversation

# Get prompt to continue previous work
basic-memory tool continue-conversation "previous topic or context"

Sync Database

basic-memory sync

Check Status

basic-memory status

Note Format

Notes are stored as markdown with YAML frontmatter:

---
title: My Note
tags: [tag1, tag2]
created: 2024-01-15
---

# My Note

Content here in markdown format.

## Sections

More content...

Workflow Patterns

Save Learning

When you discover something useful:

basic-memory tool write-note \
  --title "TypeScript Utility Types" \
  --content "# Utility Types\n\n- Partial<T> - Makes all properties optional\n- Required<T> - Makes all properties required\n- Pick<T, K> - Picks specific properties" \
  --tags "typescript,types,reference"

Save Decision

When making an architectural decision:

basic-memory tool write-note \
  --title "Auth Strategy Decision" \
  --content "# Decision: Use JWT for API auth\n\n## Context\n...\n\n## Decision\n...\n\n## Consequences\n..." \
  --tags "architecture,auth,decision" \
  --folder "decisions"

Retrieve Context

Before starting related work:

# Search for relevant notes
basic-memory tool search-notes "authentication jwt tokens"

# Or build comprehensive context
basic-memory tool build-context "memory://topic/api-authentication"

Review Recent Work

basic-memory tool recent-activity --depth 5 --timeframe 7d

Use Cases

Personal Wiki

Store code snippets and patterns
Document project decisions
Keep reference material

Learning Log

Record things you learn
Tag by topic for later retrieval
Build knowledge over time

Project Context

Save project-specific knowledge
Retrieve relevant context at session start
Share knowledge across sessions

Best Practices

Use meaningful titles - They become permalinks
Add tags - Improves search and organization
Use markdown - Full markdown support in content
Organize with folders - Group related notes
Search before writing - Check if knowledge already exists
Keep notes focused - One topic per note
Update, don't duplicate - Revise existing notes

Integration Pattern

Session Start

# Get context for today's work
basic-memory tool build-context "memory://topic/feature-youre-building"

During Work

# Save discoveries
basic-memory tool write-note --title "Discovery Title" --content "What I learned"

Session End

# Sync to ensure persistence
basic-memory sync

memory

Memory - Persistent Knowledge Storage

Prerequisites

CLI Reference

Write a Note