Notelane

---

version: "2.0.0"

name: notelane

description: "Organize notes as a personal knowledge base with tagging and full-text search. Use when capturing notes, searching entries, building a knowledge base."

---

# Notelane

Notelane v2.0.0 — a productivity toolkit for adding, planning, tracking, reviewing, and organizing notes from the command line. Features streaks, reminders, prioritization, tagging, timelines, weekly reviews, and full data export.

Commands

Run `notelane <command> [args]` to use. Each data command accepts optional input — with no arguments it shows recent entries; with arguments it records a new entry.

| Command | Description |

|---------|-------------|

| `add [input]` | Add a new note or entry |

| `plan [input]` | Record or review planning notes |

| `track [input]` | Track progress on goals or tasks |

| `review [input]` | Log review notes and reflections |

| `streak [input]` | Track daily streaks and consistency |

| `remind [input]` | Set and review reminders |

| `prioritize [input]` | Record prioritization decisions |

| `archive [input]` | Archive old notes and entries |

| `tag [input]` | Tag entries for organization |

| `timeline [input]` | Build timeline entries for projects or events |

| `report [input]` | Generate or record summary reports |

| `weekly-review [input]` | Log weekly review notes and retrospectives |

| `stats` | Show summary statistics across all entry types |

| `export <fmt>` | Export all data (formats: `json`, `csv`, `txt`) |

| `search <term>` | Full-text search across all log entries |

| `recent` | Show the 20 most recent history entries |

| `status` | Health check — version, data dir, entry count, disk usage |

| `help` | Show built-in help message |

| `version` | Print version string (`notelane v2.0.0`) |

Features

Data Storage

All data is stored in `~/.local/share/notelane/`:

Each entry is stored as `YYYY-MM-DD HH:MM|<value>` (pipe-delimited).

Requirements

When to Use

1. **Quick note capture** — run `notelane add "Meeting notes: decided to migrate to Postgres by Q3"` to instantly record a thought or decision

2. **Planning and goal tracking** — use `notelane plan "Sprint 12: finish API refactor, deploy staging"` and `notelane track "API refactor 80% complete"` to manage projects

3. **Building daily streaks** — log daily habits with `notelane streak "Day 15: morning workout done"` to maintain consistency tracking

4. **Weekly retrospectives** — use `notelane weekly-review "Shipped 3 features, 1 bug regression, need more testing"` to document weekly learnings

5. **Organizing with tags and timelines** — tag entries with `notelane tag "project:atlas priority:high"` and build event timelines with `notelane timeline "2024-03-15: v2.0 launched"`

Examples

# Show all available commands
notelane help

# Add a quick note
notelane add "Idea: build a CLI dashboard for server metrics"

# Record a plan
notelane plan "This week: finalize docs, cut release, update changelog"

# Track progress
notelane track "Documentation: 3 of 5 sections complete"

# Log a reminder
notelane remind "Send invoice to client by Friday"

# Set priorities
notelane prioritize "P0: fix auth bug; P1: add export feature; P2: refactor tests"

# Run a weekly review
notelane weekly-review "Good week — shipped auth fix, started on export. Next: testing."

# View summary statistics
notelane stats

# Search all notes
notelane search "API"

# Export everything to JSON
notelane export json

# Check tool health
notelane status

How It Works

Notelane stores all data locally in `~/.local/share/notelane/`. Each command logs activity with timestamps for full traceability. When called without arguments, data commands display their most recent 20 entries. When called with arguments, they append a new timestamped entry and update the unified history log.

---

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com