How do I install the Segundo skill?

Run npx skillmds@latest add dvcrn/segundo in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Segundo safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Segundo?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Segundo free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Segundo?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Segundo by dvcrn — Agent Skill

Name: Segundo
Rating: 4.2 (5 reviews)
Author: dvcrn

Segundo

CLI tool for capturing and retrieving thoughts as a second brain. Stores memories as daily markdown journals with optional semantic search. USE FOR: - Capturing thoughts, notes, ideas, recommendations - Searching memories by text or semantic similarity - Listing and filtering memories by date range or tags - Importing/exporting notes, viewing brain statistics Requires: bun or npm. Semantic search requires an embedding provider (Ollama or OpenAI).

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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

Init - Create a brain first with segundo init
Capture - Add thoughts with segundo add "thought"
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.

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).

---name: segundodescription: CLI tool for capturing and retrieving thoughts as a second brain. Stores memories as daily markdown journals with optional semantic search. USE FOR: - Capturing thoughts, notes, ideas, recommendations - Searching memories by text or semantic similarity - Listing and filtering memories by date range or tags - Importing/exporting notes, viewing brain statistics Requires: bun or npm. Semantic search requires an embedding provider (Ollama or OpenAI).---# segundo CLIA 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.## Workflow1. **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```bashsegundo initsegundo init --reindex # Rebuild embedding index```### add```bashsegundo add "read Designing Data-Intensive Applications" --tag booksegundo add "line one\nline two"segundo add "thought one" "thought two" "thought three" # batchecho "thought from pipe" | segundo add # stdincat notes.txt | segundo add --batch # split on blank lines```### search```bashsegundo 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```bashsegundo listsegundo list --limit 5segundo list --tag booksegundo list --from 2026-03-01 --to 2026-03-10```### edit```bashsegundo edit <id> "new content"segundo edit id1 "content1" id2 "content2" # batch```### delete```bashsegundo delete <id>segundo delete id1 id2 id3```### import```bashsegundo import notes.mdsegundo import ./notes-dir/ --tag importedsegundo import file.txt --dry-run```### export```bashsegundo exportsegundo export --format jsonsegundo export --from 2026-03-01 --to 2026-03-10 --tag book```### stats```bashsegundo stats```Shows total memory count, date range, top tags, embedding index size, and brain path.## TagsTags go on the last line of an entry. Add via `--tag` flag or inline:```bashsegundo add "great chapter on consistency\n#book #engineering"segundo add "lunch spot" --tag food```## FilteringAll 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```bashsegundo --profile work add "quarterly review notes"segundo --profile personal listsegundo --brain /custom/path list```## JSON OutputAll commands support `--json` for structured output:```bashsegundo list --jsonsegundo add "thought" --jsonsegundo search "query" --json```## StorageMemories live in `~/.segundo/memories/` as daily markdown files:```~/.segundo/ config.json memories/ 2026-03-10.md embeddings/ index.bin meta.json```## Semantic Search SetupConfigure in `~/.segundo/config.json`:```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`).

Frequently asked questions