Quickstart Guide¶

Get up and running with the notes system in 5 minutes.

Installation (2 minutes)¶

# 1. Run setup script
chmod +x notes-setup.sh
./notes-setup.sh

# 2. Add shell functions
cat notes-functions.sh >> ~/.zprofile
source ~/.zprofile

# 3. Add Neovim integration
cp notes-nvim.lua ~/.config/nvim/lua/notes.lua

Add to ~/.config/nvim/init.lua:

require('notes').setup()

Restart Neovim.

Your First Note (1 minute)¶

# Open today's note
today

In Neovim, you'll see a template with: - Primary Focus section - Today's Tasks section - Notes section - Daily Reflection section

Try this: 1. Set your Primary Focus: "Learn the notes system" 2. Add a task: - [ ] Test wiki links 3. Save and close (:wq)

Try the Core Commands (2 minutes)¶

Create a wiki page¶

wiki test-page

Add some content, then save and close.

Check your context¶

context

This shows what you're working on right now.

Quick capture¶

nquick "Remember to review pull requests"

This adds a note to today without opening the editor.

Search your notes¶

nfind test

Uses fzf to find notes interactively.

Try Neovim Features (Optional)¶

Open today's note again:

today

Create and follow links¶

Type: See [[areas/test-project]]
Press M-Enter on the link (creates area with correct template)
Press Ctrl+O to go back

Toggle tasks¶

Put cursor on a task line: - [ ] Test wiki links
Press <Space>nx (toggles checkbox)

Find notes with Telescope¶

In Neovim: - Press <Space>nf - Find any note - Press <Space>ng - Search through all notes

Daily Workflow¶

Morning (5 min)¶

today                   # Opens with yesterday's incomplete tasks carried over
# Set your Primary Focus
# Review tasks

During Work¶

context                 # When you need to remember what you're doing
nquick "quick thought"  # Quick capture

End of Day (5 min)¶

today
# Mark completed tasks: [ ] → [x]
# Add daily reflection
# Delete irrelevant tasks
# Close (incomplete tasks auto-carry to tomorrow)

Essential Commands¶

today           # Open today's note
context         # Show what you're working on
wiki <name>     # Create/open wiki page
notes-help      # Show all commands (alias: nh)

See Quick Reference for the complete command list.

Essential Keybindings (in Neovim)¶

Key	Action
`<M-CR>`	Follow [[link]] (uses correct template)
`<Space>nt`	Open today's daily log
`<Space>nf`	Find notes (Telescope)
`<Space>nx`	Toggle task checkbox

See Neovim Keybindings for the complete list.

Next Steps¶

Use it for a week: Just today and context commands
Learn the philosophy: User Guide for executive function strategies
Master workflows: Daily Workflows for practical patterns
Quick reference: Reference for command lookup

Quick Tips¶

Primary Focus: Always set it. When in doubt, work on it.
Context Command: Make it muscle memory. Type it often.
Tasks Carry Automatically: Just mark what's done, system handles the rest.
Write Everything Down: Your notes are your external memory.

That's it! You're ready to use the system. The rest is just learning the additional features at your own pace.