메뉴
Manage a personal knowledge capture system. Use when the user wants to capture ideas, track todos, organize projects, review their synap, or mentions "synap", "brain dump", "capture this", "add to my list", "what's on my plate", "what should I focus on", or "daily review".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | synap-assistant |
| description | Manage a personal knowledge capture system. Use when the user wants to capture ideas, track todos, organize projects, review their synap, or mentions "synap", "brain dump", "capture this", "add to my list", "what's on my plate", "what should I focus on", or "daily review". |
A CLI for externalizing your working memory - capture ideas, projects, features, todos, and questions without the overhead of complex tools.
Your brain is for having ideas, not holding them. But sticky notes get lost, notepads pile up unread, and tools like Asana are overkill for personal capture.
synap solves this by providing:
When assisting users with their synap entries:
Capture first, organize later - Never block on classification during fast capture. Get the thought out, refine later.
Proactive triage - Regularly surface raw entries needing processing. Don't let the inbox grow stale.
Connect the dots - Link related entries, identify patterns, consolidate ideas into projects.
Reduce cognitive load - Present summaries and prioritized lists, not exhaustive dumps.
Preserve context - Include enough detail for future recall. A cryptic note is useless later.
Respect simplicity - Simple thoughts don't need tags, priorities, and parents. Don't over-engineer.
synap stores user data in a configurable data directory (default: ~/.config/synap/).
Data files (syncable):
entries.json - Active entriesarchive.json - Archived entriesuser-preferences.md - Agent memory / user preferencesConfig files (local only):
config.json - Settings (including dataDir for custom data location)deletion-log.json - Audit trail for restoreUsers can point synap to a custom folder (e.g., a git repo for multi-device sync):
synap config dataDir ~/synap-data
# Or during setup:
synap setup
When custom dataDir is set:
~/.config/synap/synap preferences set --section "Tag Meanings" --entry "#urgent = must do today".synap preferences remove --section tags --match "urgent".synap preferences list --section tags --json.synap preferences --append "## Section" "..." is still supported for raw appends.Detect user intent and respond appropriately:
| Mode | Triggers | Behavior |
|---|---|---|
| Capture | "Add this...", "Remind me...", "I had an idea..." | Fast capture, minimal questions, default to idea type |
| Review | "What's on my plate?", "Daily review", "Show me..." | Stats + prioritized summary, grouped by type |
| Triage | "Process my synap", "Process my brain dump", "What needs attention?" | Surface raw entries, help classify and prioritize |
| Focus | "What should I work on?", "Priority items" | WIP items + P1 todos + active projects, clear next actions |
| Cleanup | "Archive completed", "Clean up old stuff" | Bulk operations with preview and confirmation |
| Mode | Trigger | Behavior |
|---|---|---|
| Quick | <10 entries returned | Direct answers, lightweight summaries, minimal batching |
| Deep | 10+ entries returned | Summarize first, propose batches, confirm before bulk actions |
| Task | Command |
|---|---|
| Capture idea | synap add "your thought here" |
| Add todo | synap todo "task description" |
| Add todo with due date | synap todo "Review PR #42" --due tomorrow |
| Add question | synap question "what you're wondering" |
| List active | synap list |
| See all | synap list --all |
| Search | synap search "keyword" |
| Show details | synap show <id> |
| Mark done | synap done <id> |
| Start working | synap start <id> |
| Stop working | synap stop <id> |
| Get stats | synap stats |
| Setup wizard | synap setup |
| Edit preferences | synap preferences --edit |
| Set preference | synap preferences set --section tags --entry "#urgent = must do today" |
Before operations, verify the tool is ready:
synap --version # Verify installed
synap stats # Quick health check
If synap: command not found, the user needs to install: npm install -g synap
synap add <content>Quick capture of a thought.
synap add "What if we used a graph database?"
synap add "Need to review the API design" --type todo --priority 1
synap add "Prep for demo" --type todo --due 2025-02-15
synap add "Meeting notes from standup" --type note --tags "meetings,weekly"
synap add --type project --title "Website Redesign" "Complete overhaul of the marketing site..."
Options:
--type <type>: idea, project, feature, todo, question, reference, note (default: idea)--title <title>: Short title (auto-extracted from first line if not provided)--priority <1|2|3>: 1=high, 2=medium, 3=low--tags <tags>: Comma-separated tags--parent <id>: Parent entry ID--due <date>: Due date (YYYY-MM-DD, 3d/1w, weekday names: monday/friday, or keywords: today, tomorrow, next monday)--json: JSON outputsynap todo <content>Shorthand for adding a todo.
synap todo "Review PR #42"
# Equivalent to: synap add "Review PR #42" --type todo
Options: --priority, --tags, --parent, --due, --json
synap question <content>Shorthand for adding a question.
synap question "Should we migrate to TypeScript?"
# Equivalent to: synap add "..." --type question
Options: --priority, --tags, --parent, --due, --json
synap log <id> <message>Add a timestamped log entry under a parent entry.
synap log a1b2c3d4 "Started implementation"
synap log a1b2c3d4 "Completed first draft" --inherit-tags
Options:
--inherit-tags: Copy tags from parent entry--json: JSON outputsynap batch-addAdd multiple entries in one operation.
# From file
synap batch-add --file entries.json
# From stdin (pipe)
echo '[{"content":"Task 1","type":"todo"},{"content":"Task 2","type":"todo"}]' | synap batch-add
# Dry run
synap batch-add --file entries.json --dry-run
Input format (JSON array):
[
{"content": "First entry", "type": "idea"},
{"content": "Second entry", "type": "todo", "priority": 1, "tags": ["work"]}
]
Options:
--file <path>: Read from JSON file--dry-run: Preview what would be added--json: JSON outputsynap listList entries with filtering.
synap list # Active + raw (default)
synap list --all # All except archived
synap list --type todo # Only todos
synap list --status raw # Needs triage
synap list --priority 1 # High priority only
synap list --tags work,urgent # Has ALL specified tags
synap list --since 7d # Created in last 7 days
synap list --overdue # Overdue entries
synap list --due-before 7d # Due in next 7 days
synap list --has-due # Entries with due dates
synap list --json # JSON output for parsing
Options:
--type <type>: Filter by entry type--status <status>: raw, active, wip, someday, done, archived (default: raw,active)--tags <tags>: Comma-separated, AND logic--priority <1|2|3>: Filter by priority--parent <id>: Children of specific entry--orphans: Only entries without parent--since <duration>: e.g., 7d, 24h, 2w--due-before <date>: Due before date (YYYY-MM-DD or 3d/1w)--due-after <date>: Due after date (YYYY-MM-DD or 3d/1w)--overdue: Only overdue entries--has-due: Only entries with due dates--no-due: Only entries without due dates--all: All statuses except archived--done: Include done entries--archived: Show only archived--limit <n>: Max entries (default: 50)--sort <field>: created, updated, priority, due--reverse: Reverse sort order--json: JSON outputsynap show <id>Show full entry details.
synap show a1b2c3d4
synap show a1b2c3d4 --with-children
synap show a1b2c3d4 --with-related
synap show a1b2c3d4 --json
synap search <query>Full-text search across content and titles.
synap search "database"
synap search "meeting" --type note --since 30d
synap search "API" --json
synap edit <id>Edit entry content.
synap edit a1b2c3d4 # Opens $EDITOR
synap edit a1b2c3d4 --content "New text" # Non-interactive
synap edit a1b2c3d4 --append "Follow-up" # Add to existing
synap edit a1b2c3d4 --title "New title"
synap set <id>Update entry metadata.
synap set a1b2c3d4 --type project
synap set a1b2c3d4 --status active
synap set a1b2c3d4 --priority 1
synap set a1b2c3d4 --tags "work,Q1"
synap set a1b2c3d4 --add-tags "important"
synap set a1b2c3d4 --remove-tags "draft"
synap set a1b2c3d4 --clear-priority
synap set a1b2c3d4 --parent b2c3d4e5
synap link <id1> <id2>Create relationships between entries.
synap link a1b2c3d4 b2c3d4e5 # Add to related
synap link a1b2c3d4 b2c3d4e5 --as-parent # Set hierarchy
synap link a1b2c3d4 b2c3d4e5 --unlink # Remove relationship
synap done <ids...>Mark entries as done.
synap done a1b2c3d4
synap done a1b2c3d4 b2c3d4e5 c3d4e5f6 # Multiple
synap done --type todo --tags "sprint-1" # By filter
synap done --dry-run --type todo # Preview first
synap start <ids...>Start working on entries (mark as WIP).
synap start a1b2c3d4 # Single entry
synap start a1b2c3d4 b2c3d4e5 # Multiple
synap start --type todo --tags urgent # By filter
synap start --dry-run --type todo # Preview first
Options:
-t, --type <type>: Filter by type--tags <tags>: Filter by tags--dry-run: Show what would be started--json: JSON outputsynap stop <ids...>Stop working on entries (remove WIP status).
synap stop a1b2c3d4 # Single entry
synap stop --all # Stop all WIP entries
synap stop --dry-run # Preview first
Options:
--all: Stop all WIP entries--dry-run: Show what would be stopped--json: JSON outputsynap archive <ids...>Archive entries (hides from default view).
synap archive a1b2c3d4
synap archive --status done --since 30d # Old completed items
synap archive --dry-run --status done # Preview
synap delete <ids...>Delete entries (logged for undo).
synap delete a1b2c3d4
synap delete a1b2c3d4 b2c3d4e5 --confirm
synap delete --status archived --since 90d # Permanent cleanup
synap delete --dry-run --type reference # Preview
Safety:
10 entries requires
--confirmor--force
--forcesynap restoreRestore deleted entries.
synap restore --last 1 # Most recent
synap restore --last 5 # Last 5
synap restore --ids a1b2c3d4,b2c3d4e5 # Specific IDs
synap restore --list # Show deletion log
synap statsOverview statistics.
synap stats
synap stats --json
synap exportExport entries.
synap export # All to stdout
synap export --file backup.json # To file
synap export --type todo --status active # Filtered
synap import <file>Import entries.
synap import backup.json
synap import backup.json --dry-run
synap import backup.json --merge # Update existing + add new
synap import backup.json --skip-existing # Only add new
synap configView or update configuration.
synap config # Show all settings + paths
synap config dataDir # Show data directory
synap config --reset # Reset to defaults
synap save, synap pull, synap syncGit sync commands for multi-device workflow.
# Save (commit + push)
synap save # Commit + push with auto timestamp
synap save "message" # Commit + push with custom message
synap save -m "message" # Same as above
synap save --dry-run # Preview changes without committing
synap save --no-push # Commit locally, don't push
# Pull
synap pull # Pull latest from remote
synap pull --force # Pull even with uncommitted local changes
# Sync (pull + save)
synap sync # Pull then save (full round-trip)
synap sync "end of day" # Sync with custom commit message
synap sync --dry-run # Preview what would happen
synap sync --no-push # Pull and commit, but don't push
Git sync error codes:
| Code | Meaning |
|---|---|
NOT_GIT_REPO | Data directory is not a git repository |
DIRTY_WORKING_TREE | Uncommitted changes block pull (use --force) |
MERGE_CONFLICT | Pull resulted in merge conflicts |
NO_REMOTE | No git remote configured |
PUSH_FAILED | Remote exists but push failed |
Set data directory:
synap config dataDir ~/synap-data
Initialize git (one-time):
cd $(synap config dataDir)
git init
git remote add origin git@github.com:user/synap-data.git
synap save "Initial commit"
Daily workflow:
synap pull # Start of day
synap save # End of day
synap sync # Or full round-trip
New device:
git clone git@github.com:user/synap-data.git ~/synap-data
synap config dataDir ~/synap-data
Run this each morning to get oriented:
synap statssynap list --status rawsynap list --priority 1 --type todoRun this weekly to maintain hygiene:
synap list --done --since 7d - show what was accomplishedsynap list --status active --sort updated - find items not touchedsynap list --type project - are they progressing?synap archive --status done --since 7d - archive completed itemsWhen user has many raw entries:
synap list --status raw --jsonsynap set <id> --type todo --priority 1 --tags "work"synap set <id> --status activeWhen user is dumping thoughts rapidly:
synap add "..." - don't interrupt for classificationSmart status defaulting: When capturing with priority set, the CLI auto-promotes to active status (skipping triage). When adding entries with full metadata (priority, tags, due), there's no need to manually set status—the entry is already triaged.
After capture sessions, detect opportunities to group related entries:
| Signal | Action |
|---|---|
| 3+ entries with same tag in one session | Suggest parent project with that tag as context |
| 3+ entries mentioning same keyword/topic | Suggest linking as related or creating parent |
| User mentions "for the X project" multiple times | Proactively suggest creating/linking to X project |
Grouping workflow:
synap list --since 1h --jsonsynap add "[Topic] Project" --type project --tags "topic"synap link <child-id> <project-id> --as-parentFor projects requiring ongoing progress logging (standups, journals, learning logs):
| Signal | Action |
|---|---|
| Project mentions "daily", "track progress", "standup" | Suggest daily tracking setup |
| User says "I need to log progress on X" | Explain synap log workflow |
Project has --tags daily-tracking | Ask for today's update |
Daily tracking workflow:
Setup: Create a project to track
synap add "Learn Rust" --type project --tags "learning,daily-tracking"
Daily logging: Add timestamped progress
synap log <project-id> "Completed chapter 3"
Review progress: View the log tree
synap tree <project-id>
When to suggest: User creates learning/progress project, mentions accountability, or asks about daily tracking.
Do NOT auto-create - always confirm with user first.
| Indicator | Likely Type |
|---|---|
| Starts with action verb ("Build", "Write", "Fix", "Review") | todo |
| Contains "?" or seeking information | question |
| Multi-step initiative, long-term scope | project |
| Specific capability/enhancement within a project | feature |
| Link, quote, or factual information | reference |
| Observation with no clear action | note |
| Speculative, "what if", creative | idea |
| Priority | Criteria |
|---|---|
| P1 (high) | Blocking other work, deadline within 48h, explicitly urgent |
| P2 (medium) | Important but not urgent, this-week scope |
| P3 (low) | Nice-to-have, someday-maybe, learning/exploration |
| None | Truly unprioritized, needs triage |
Non-negotiable constraints:
synap restoreGit sync safety:
--dry-run to preview changes before committingMERGE_CONFLICT errors require manual resolutionpull checks for dirty tree; use --force only when safesynap triage.synap focus.--dry-run whenever available before bulk changes.Critical for preventing accidental mass changes:
synap delete --status archived --since 90d --dry-runsynap delete --ids "<specific-ids>" --confirmPrinciple: Filters are for DISCOVERY, IDs are for EXECUTION.
| User Says | Interpretation | Action |
|---|---|---|
| "Add this to my synap" | Fast capture | synap add "<content>" |
| "I need to remember to..." | Todo item | synap todo "<content>" |
| "What's on my plate?" | Need overview | synap stats + synap list --priority 1 |
| "What should I focus on?" | Need priorities | synap list --priority 1 --type todo |
| "Process my synap" | Triage needed | Run triage workflow on raw entries |
| "This is done" / "I finished X" | Mark complete | synap done <id> |
| "Archive old stuff" | Cleanup | synap archive --status done --since 30d |
| "What did I do this week?" | Review completions | synap list --done --since 7d |
| "Find anything about X" | Search | synap search "X" |
| "Link these together" | Create relationship | synap link <id1> <id2> |
| Problem | Solution |
|---|---|
synap: command not found | Run npm install -g synap |
| Empty synap | Start with synap add "My first thought" |
| Too many raw entries | Run triage workflow |
| Can't find entry | Use synap search "<keyword>" |
| Accidentally deleted | Use synap restore --last 1 |
| Wrong type/status | Use synap set <id> --type <type> --status <status> |
| Scenario | Expected Behavior | Failure Indicator |
|---|---|---|
| User says "capture this" | Immediate synap add, no questions | Asking for type/priority during fast capture |
| User says "what's on my plate" | Stats + prioritized summary | Listing all 50 entries individually |
| User says "clean up" | Preview + confirmation | Auto-archiving without preview |
| Large deletion (>10 items) | Show count, ask confirmation | Proceeding without confirmation |
| User mentions deadline | Suggest P1 priority | Not detecting urgency |
| User's idea relates to existing project | Suggest linking | Not checking for related entries |
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"content": "The full text of the entry",
"title": "Short title (optional)",
"type": "idea|project|feature|todo|question|reference|note",
"status": "raw|active|wip|someday|done|archived",
"priority": 1|2|3|null,
"tags": ["tag1", "tag2"],
"parent": "parent-id|null",
"related": ["id1", "id2"],
"due": "2026-01-10T23:59:59.000Z",
"startedAt": "2026-01-10T08:30:00.000Z",
"createdAt": "2026-01-05T08:30:00.000Z",
"updatedAt": "2026-01-05T08:30:00.000Z",
"source": "cli|agent|import"
}
{
"success": true,
"entries": [...],
"total": 47,
"returned": 12,
"query": {
"status": ["raw", "active"],
"limit": 50
}
}
{
"success": false,
"error": "Entry not found: a1b2c3d4",
"code": "ENTRY_NOT_FOUND"
}
Best practices for Remotion - Video creation in React
Regenerate skill indexes for Cline. ONLY use when the user EXPLICITLY asks to "update skill index", "sync skills", "regenerate index", or "update cline_overview.md". Do NOT auto-invoke after creating/modifying skills.
Browser automation with persistent page state. Use when users ask to navigate websites, fill forms, take screenshots, extract web data, test web apps, or automate browser workflows. Trigger phrases include "go to [url]", "click on", "fill out the form", "take a screenshot", "scrape", "automate", "test the website", "log into", or any browser interaction request.
Manage Gmail inbox with AI-powered triage, cleanup, and restore. Use when the user mentions inbox, email triage, clean inbox, email cleanup, check email, email summary, delete emails, manage inbox, or wants to organize their email.
MANDATORY - You must load this skill before doing anything else. This defines how you operate.
Calculate the optimal token usage burn rate to reach exactly 100% usage by reset. Use when the user asks about token budget, usage limits, spending speed, or "will I run out". Supports Claude, Gemini, Codex, VS Code, and other providers.