npm install -g @llipe.com/memo-cli
memo --version

git clone https://github.com/llipe/memo-cli.git
cd memo-cli
pnpm install
pnpm run build
./dist/index.js --help

docker run -p 6333:6333 qdrant/qdrant

memo setup init

memo write \
  --rationale "Chose Qdrant over Pinecone for self-hosting flexibility and payload filtering." \
  --tags "architecture,storage,qdrant" \
  --entry-type decision \
  --source agent

memo search "why did we choose the vector database"

memo setup init

memo setup init \
  --repo my-service \
  --org my-company \
  --domain backend \
  --relates-to "auth-service,api-gateway"

memo setup show        # display effective config
memo setup validate    # check config validity (exit 0 = valid)

memo write \
  --rationale "Adopted JWT with RS256 for service-to-service auth. Short-lived tokens (15 min) with refresh rotation." \
  --tags "auth,jwt,security" \
  --entry-type decision \
  --source agent

# Agent mode: automatically merge duplicates
memo write \
  --rationale "Updated JWT decision to include ECDSA as fallback." \
  --tags "auth,jwt,security,ecdsa" \
  --entry-type decision \
  --source agent \
  --commit abc1234 \
  --on-duplicate consolidate \
  --json

memo search "how do we handle authentication"

# Only search within this repo (default)
memo search "database connection pooling" --scope repo

# Include related repos defined in config
memo search "how does the auth service validate tokens" --scope related

# Require specific tags (AND semantics)
memo search "API rate limiting" --tags "api,rate-limit"

# Filter by entry type
memo search "module boundaries" --entry-type structure

# Limit results
memo search "caching strategy" --limit 5

# Combine filters
memo search "event publishing" \
  --scope related \
  --tags "events,kafka" \
  --entry-type integration_point \
  --limit 3

memo list                    # last 20 entries for this repo
memo list --limit 50         # last 50 entries

# Entries from a specific date
memo list --from 2026-04-01

# Entries in a date range
memo list --from 2026-04-01 --to 2026-04-10

# Full ISO 8601 timestamps also work
memo list --from 2026-04-01T00:00:00Z --to 2026-04-10T23:59:59Z

memo list --tags "auth,jwt"
memo list --entry-type decision
memo list --source agent --limit 10

memo setup show          # human-readable
memo setup show --json   # JSON output

memo setup validate
# Exit code 0 = valid, 1 = errors found

memo setup init --force

memo tags list

# Include related repos from config
memo tags list --scope related

# Sort alphabetically (default: frequency)
memo tags list --sort alpha

# JSON output for agent consumption
memo tags list --json

memo inspect

# Only repositories
memo inspect --repos

# Only organizations
memo inspect --orgs

# Only domains
memo inspect --domains

# JSON output
memo inspect --json

memo delete --id 550e8400-e29b-41d4-a716-446655440000

# Delete all entries for a repository
memo delete --all-by-repo my-service

# Delete all entries for an organization
memo delete --all-by-org my-company

memo delete --id <id> --yes
memo delete --all-by-repo my-service --yes

memo delete --id <id> --json
# outputs: { "deleted": true, "id": "...", "scope": "single", "count": 1 }

# 1. Before starting a task — search for prior decisions
memo search "authentication strategy for microservices" --json

# 2. After completing a task — write the decision
memo write \
  --rationale "Implemented OAuth2 with PKCE for the mobile client. Chose this over implicit flow for security." \
  --tags "auth,oauth2,mobile" \
  --entry-type decision \
  --source agent \
  --commit "$(git rev-parse HEAD)" \
  --story "PROJ-123" \
  --on-duplicate consolidate \
  --json

# 3. Verify the write
memo search "OAuth2 mobile client" --json | jq '.count'

export QDRANT_URL=http://localhost:6333
export EMBEDDINGS_API_KEY=sk-...

# 1. Copy the skill
cp -r .github/skills/memo-cli-usage /path/to/your-repo/.github/skills/

# 2. Register it in your AGENTS.md or skill registry:
# | memo-cli-usage | .github/skills/memo-cli-usage/ | Agent guidance for memo-cli | Any agent |

# 3. Install memo-cli
pnpm add -D @llipe.com/memo-cli

# 4. Initialize the repo
npx memo setup init --repo <name> --org <org> --domain <domain>

# Validate a bootstrap JSON file
node --loader ts-node/esm scripts/validate-bootstrap.ts ./my-bootstrap.json

git clone https://github.com/llipe/memo-cli.git
cd memo-cli
pnpm install
cp .env.example .env   # configure credentials

pnpm run test                          # all tests
pnpm run test -- --testPathPattern=write   # specific module
pnpm run test:coverage                 # with coverage report