# pimterry/notes

:pencil: Simple delightful note taking, with more unix and less lock-in.

Repository: https://github.com/pimterry/notes
Canonical: https://ross.abutalabs.com/products/pimterry-notes
Homepage: https://github.com/pimterry/notes
Language: Shell
License: MIT
License Family: permissive
Topics: notes, note-taking, shell-script, productivity, unix, markdown, zsh, sync
Last push: 2024-01-05T19:20:20+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3563, "days_push": 971, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1321, forks 81 (observed 2026-08-28T04:04:21.898543+00:00)

## What it is
A shell-based command line tool for taking notes as plain markdown text files in a folder. It glues together your own editor and file-syncing solution, adding commands to create, search, and manage notes without any proprietary format or lock-in.

## Use cases
- take notes from the terminal in markdown
- keep notes as plain text files synced with dropbox
- quickly create and search notes from the command line
- avoid vendor lock-in with note-taking apps
- edit notes with vim or any editor I choose
- manage a folder of notes with tab completion in bash or zsh

## When to choose
- you live in the terminal and want fast note creation and lookup
- you want notes as portable plain-text markdown files you own
- you already have a sync service and a favorite text editor
- you want a lightweight unix-style tool instead of a bloated app

## When to avoid
- you want a graphical or mobile note-taking UI
- you need rich formatting, attachments, or web clipping
- you prefer an all-in-one app with built-in sync
- you need collaborative editing features

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, markdown, file-system, developer-tools
- domain: developer-tools, text-editors, files
- platform: cli, cross-platform
- tags: note-taking, shell-script, unix-philosophy, plain-text, zsh, sync-friendly, no-lock-in, command-line, linux, macos

## Member repositories
- pimterry/notes (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:21.898543+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:19.946521+00:00, confidence not recorded.
  - readme: https://github.com/pimterry/notes (fetched 2026-08-28T04:04:21.898543+00:00, sha efd8cc48a364)
  - homepage: https://github.com/pimterry/notes (fetched 2026-08-29T12:06:10.404642+00:00, sha a06a1244fd9a)
- Data as of 2026-08-30T08:39:29.467469+00:00.