Kaydet (pronounced "kai-det", Turkish for "record") is a terminal note-taking application for developers. Capture work logs, ideas, daily notes, and structured metadata in plain text. Instantly search everything with SQLite FTS, and let your AI search your history too.
Never lose a solution twice. Terminal note-taking app for developers. CLI notes, work logs, daily journal, with SQLite FTS search and MCP AI integration.
Estrelas
51
Ferramentas
—
Disponibilidade
—
Install
pipx install kaydet
With AI (MCP) support:
pipx install kaydet[mcp]
Also available via:
uv tool install kaydet # uv
Quick Start
# Capture a solution (terminal notes, instantly)
kaydet "Fixed auth race condition commit:abc123 issue:312"
# Pipe command output into a new entry
ls -lah | kaydet
git log -5 --oneline | kaydet #git
# 6 months later — find it
kaydet --filter auth
# Log what you worked on (work log / developer diary)
kaydet "Deep work on ETL pipeline #work time:3h focus:high"
# Todo from the command line (CLI notes + tasks)
kaydet --todo "Write unit tests priority:high"
kaydet --done 42
# Search by metadata
kaydet --filter "status:done"
kaydet --filter "time:>2"
# Open today's entry in your editor
kaydet --today
# See your stats (plain text notes, searchable)
kaydet --stats
AI Integration
Powered by MCP (Model Context Protocol). Connect Claude Desktop, Cursor, or any MCP-compatible tool:
"How much did I spend this month?" (#expense since:2026-07-01 --sum)
"What did I learn about auth bugs?" (search_entries + since:)
"Summarize my accomplishments from last sprint"
"What expenses did I log in March with cost > 1000?" (#expense since:2026-03-01 cost:>1000)
"Show me pending high-priority todos" (list_todos status:pending filter:#work)
Your AI grounded in your own data. Not generic knowledge — your knowledge.
MCP Tools
Built-in MCP server with 14 tools:
Tool
What it does
add_entry
Create a new diary entry with text, tags, metadata
search_entries
Full FTS5 search with tag, metadata, date filters
summarize_entries
Sum numeric metadata across matching entries (supports since:, tags)
list_recent_entries
Browse recent entries
entries_by_tag
Filter entries by a specific tag
get_entry
Fetch a single entry by ID
update_entry
Edit entry text, tags, or metadata
delete_entry
Remove an entry by ID
create_todo
Create a todo with optional metadata
mark_todo_done
Mark a todo as completed
list_todos
List todos by status (pending/done/all) with optional filter
list_tags
Show all tags with entry counts
get_stats
Get entry counts for a given month
suggest_kaydet_tags
Suggest tags based on current project directory
Architecture
┌─────────────────────┐
│ Claude Desktop │
│ or any MCP client │
└────────┬────────────┘
│ MCP protocol
┌────────▼────────────┐
│ kaydet-mcp │
└────────┬────────────┘
│
┌───┴───┐
┌────▼───┐ ┌─▼────────────┐
│ daily │ │ SQLite index │
│ .txt │ │ (FTS5 full- │
│ files │ │ text search)│
└────┬───┘ └──────────────┘
│
▼
Google Drive / iCloud / Dropbox
Why Kaydet?
Never lose a solution twice. How many times have you fixed a bug, then six months later faced the same problem with no memory of how you solved it? Kaydet is your external memory — a searchable notes database that lives in your terminal.
Zero friction. One command from your terminal. No app windows, no context switching, no loading screens. The fastest CLI notes workflow you'll find.
Plain text ownership. Daily .txt files you can grep, version with git, sync however you like. Your data outlives any app. True plain text notes with no lock-in.
Queryable database. SQLite FTS5 index with full-text search, structured metadata (time:>2, status:done), and numeric comparisons. Real SQLite FTS search across thousands of entries.
AI-native. Your AI can read and write your notes. It's not a chatbot with generic knowledge — it's an AI that knows your work history. Built from day one with AI integration.
How Kaydet Compares
vs CLI Tools
kaydet
jrnl
nb
Toney
Terminal notes
✅
✅
✅
✅
Developer diary
✅
❌ notebook
❌ notebook
❌
Work log
✅ daily files
❌
❌
❌
SQLite FTS search
✅ FTS5
❌
❌ grep
❌
Structured metadata
✅ time:>2
❌
❌
❌
AI/MCP server
✅
❌
❌
❌
Plain text files
✅
✅
✅
❌
Todo management
✅
❌
✅
❌
Edit/delete by ID
✅
❌
❌
❌
Git sync
✅ --init --sync
❌
✅ (automatic)
❌
Language
Python
Python
Shell
Go
vs Knowledge Apps
kaydet
Obsidian
Notion
Terminal-native
✅
❌
❌
Offline first
✅
✅
❌
Plain text
✅
✅
❌
Git-friendly
✅
❌
❌
AI access (MCP)
✅
partial
partial
Structured metadata queries
✅
❌
❌
Zero friction capture
✅
❌
❌
Features
Todo management: Built-in task tracking with --todo and --done
Structured metadata:key:value syntax with numeric comparisons (time:>2, status:done, priority:high)
Smart tagging: Hashtags (#work, #bug) and metadata in one natural string
Edit/delete by ID: Stable numeric identifiers for every entry
File attachments: Attach files with --attach or move with --grab
Plain text storage: Human-readable .txt files, one per day
SQLite FTS5 indexing: Fast full-text search across thousands of entries
Git sync: Built-in --init, --sync, and --status commands
MCP integration: Connect Claude Desktop, Cursor, and any MCP-compatible AI
Usage
Basic Commands
# Add an entry
kaydet "Morning standup went well #work"
# Add with metadata
kaydet "Deep work session #focus time:3h intensity:high project:kaydet"
# Attach files
kaydet "Meeting notes" --attach notes.pdf
kaydet "Screenshot" --grab screen.png # copies + removes original
# Search & Filter
kaydet --filter "#work"
kaydet --filter "project:kaydet status:done"
kaydet --filter "time:>2"
kaydet --list # list today's entries
kaydet --today # open today's file in editor
kaydet --get 42 # show entry by ID
# Todo Management
kaydet --todo "Write unit tests priority:high"
kaydet --done 42 # Mark todo as done
kaydet --todo # List pending todos
# View
kaydet --tags # List all tags with counts
kaydet --stats # Show calendar and stats
kaydet --folder # Open log directory
kaydet --format json --filter "#work" # JSON output
# Edit & Delete
kaydet --edit 42 # Open in editor
kaydet --edit 42 "Updated message" # Inline update
kaydet --delete 42 # Delete by ID
kaydet --delete 42 --yes # Skip confirmation
# Sync (Git)
kaydet --init "https://github.com/you/notes.git" # Init repo + set remote
kaydet --sync # Commit + push + pull
kaydet --status # Show working tree status
# Management
kaydet --doctor # Rebuild search index
kaydet --config # Edit config file
kaydet --reminder # Show writing reminder
kaydet --at "2024-01-15:14:30" "Note" # Backdated entry
# Version
kaydet --version
Need a literal # in your note? Escape it as \# (e.g.,
kaydet "Budget was \#1").
Entry Format
Entries are stored as plain text with this format:
If STORAGE_DIR is omitted, Kaydet picks a sensible default on first run:
macOS / Windows → ~/Documents/Kaydet
Linux → ~/Kaydet
Prefer hidden/XDG dirs? Change STORAGE_DIR (e.g., ~/.local/share/kaydet) in
config.ini and rerun kaydet --config; the CLI offers to move files for you.
Color Customization
You can customize output colors by adding these to [SETTINGS] in config.ini:
kaydet "Lunch with client #expense amount:850 currency:TRY billable:yes"
kaydet --filter "billable:yes" # Generate invoice data
Sync
Kaydet separates storage (plain text files) from index (SQLite database). Only the plain text files are synced — each device builds its own search index locally. Minimal sync conflicts, no infrastructure cost.
Never lose a solution twice. Terminal note-taking app for developers. CLI notes, work logs, daily journal, with SQLite FTS search and MCP AI integration.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Kaydet?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Kaydet precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Kaydet usa?
Kaydet roda localmente via stdio.
Quando Kaydet foi verificado pela última vez?
Última verificação: 2026-11-11. Never lose a solution twice. Terminal note-taking app for developers. CLI notes, work logs, daily journal, with SQLite FTS search and MCP AI integration.