segundo CLI

A zero-friction second brain CLI. Captures thoughts as daily markdown journals with tags and semantic search. Built with TypeScript, runs on Bun.

Run segundo --help for usage details.

Workflow

1. Init - Create a brain first with segundo init
2. Capture - Add thoughts with segundo add "thought"
3. Retrieve - Search or list memories

Need	Command	When
Create brain	segundo init	First time setup
Capture thought	segundo add "thought" [--tag foo]	Have something to remember
Search	segundo search "query"	Find a specific memory
List recent	segundo list [--limit N]	Browse recent memories
Stats	segundo stats	See brain overview

Commands

init

segundo init
segundo init --reindex   # Rebuild embedding index

add

segundo add "read Designing Data-Intensive Applications" --tag book
segundo add "line one\nline two"
segundo add "thought one" "thought two" "thought three"   # batch
echo "thought from pipe" | segundo add                     # stdin
cat notes.txt | segundo add --batch                        # split on blank lines

search

segundo search "restaurant"
segundo search "data" --limit 5 --from 2026-01-01

Uses semantic search when an embedding provider is configured, falls back to text search otherwise.

list

segundo list
segundo list --limit 5
segundo list --tag book
segundo list --from 2026-03-01 --to 2026-03-10

edit

segundo edit <id> "new content"
segundo edit id1 "content1" id2 "content2"   # batch

delete

segundo delete <id>
segundo delete id1 id2 id3

import

segundo import notes.md
segundo import ./notes-dir/ --tag imported
segundo import file.txt --dry-run

export

segundo export
segundo export --format json
segundo export --from 2026-03-01 --to 2026-03-10 --tag book

stats

segundo stats

Shows total memory count, date range, top tags, embedding index size, and brain path.

Tags

Tags go on the last line of an entry. Add via --tag flag or inline:

segundo add "great chapter on consistency\n#book #engineering"
segundo add "lunch spot" --tag food

Filtering

All list/search/export commands support:

• --tag <name> - filter by tag
• --from <DATE> - start date (inclusive)
• --to <DATE> - end date (inclusive)
• --limit <N> - max results

Profiles

segundo --profile work add "quarterly review notes"
segundo --profile personal list
segundo --brain /custom/path list

JSON Output

All commands support --json for structured output:

segundo list --json
segundo add "thought" --json
segundo search "query" --json

Storage

Memories live in ~/.segundo/memories/ as daily markdown files:

~/.segundo/
  config.json
  memories/
    2026-03-10.md
  embeddings/
    index.bin
    meta.json

Semantic Search Setup

Configure in ~/.segundo/config.json:

{
  "embeddings": {
    "provider": "ollama",
    "model": "nomic-embed-text",
    "ollamaUrl": "http://localhost:11434"
  }
}

Supports Ollama (local, free) and OpenAI (cloud, requires openaiApiKey or $OPENAI_API_KEY).