jotjot 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Maze Heart
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# JotJot
+
+A minimal CLI for quickly jotting down notes.
+
+## Install
+
+Requires Node.js 20 or later and pnpm.
+
+```sh
+pnpm install
+pnpm build
+pnpm link --global
+```
+
+## Usage
+
+Create a note:
+
+```sh
+jot "This is a test"
+```
+
+List notes, newest first:
+
+```sh
+jot list
+jot ls
+```
+
+Fuzzy-search notes:
+
+```sh
+jot find "test"
+jot f "test"
+```
+
+Edit a note:
+
+```sh
+jot edit <id>
+jot edit <id> "Updated text"
+```
+
+Remove a note:
+
+```sh
+jot remove <id>
+jot rm <id>
+jot rm <id> --force
+```
+
+IDs can be shortened to any unique prefix. If a prefix matches multiple notes,
+JotJot asks you to choose one.
+
+## Storage
+
+Notes are stored locally as JSON in `~/.jotjot/db.json`.

package/dist/bin/app.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+
+// bin/app.ts
+import chalk2 from "chalk";
+
+// src/index.ts
+import { confirm, input, select } from "@inquirer/prompts";
+import chalk from "chalk";
+import { Command } from "commander";
+import Fuse from "fuse.js";
+import { nanoid } from "nanoid";
+
+// package.json
+var package_default = {
+  name: "jotjot",
+  version: "0.1.0",
+  type: "module",
+  bin: {
+    jot: "dist/bin/app.js"
+  },
+  main: "dist/bin/app.js",
+  files: [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  repository: {
+    type: "git",
+    url: "git+https://github.com/remvze/jotjot.git"
+  },
+  homepage: "https://github.com/remvze/jotjot#readme",
+  bugs: {
+    url: "https://github.com/remvze/jotjot/issues"
+  },
+  engines: {
+    node: ">=20"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  scripts: {
+    lint: "biome check .",
+    "lint:fix": "biome lint --write .",
+    format: "biome format --write .",
+    prepare: "husky",
+    commit: "git-cz",
+    release: "standard-version --no-verify",
+    "release:major": "pnpm run release --release-as major",
+    "release:minor": "pnpm run release --release-as minor",
+    "release:patch": "pnpm run release --release-as patch",
+    build: "tsup-node",
+    dev: "tsup-node --watch",
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "cli",
+    "notes",
+    "note-taking",
+    "jot",
+    "terminal",
+    "productivity"
+  ],
+  author: "Maze",
+  license: "MIT",
+  description: "A minimal CLI for quickly jotting down notes.",
+  devDependencies: {
+    "@biomejs/biome": "2.0.6",
+    "@commitlint/cli": "19.8.1",
+    "@commitlint/config-conventional": "19.8.1",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/node": "^24.0.10",
+    commitizen: "4.3.1",
+    "cz-conventional-changelog": "3.3.0",
+    husky: "9.1.7",
+    "lint-staged": "16.1.2",
+    "standard-version": "9.5.0",
+    tsup: "8.5.0"
+  },
+  dependencies: {
+    "@inquirer/prompts": "8.7.2",
+    chalk: "6.0.0",
+    commander: "14.0.0",
+    "fuse.js": "7.5.0",
+    lowdb: "7.0.1",
+    nanoid: "6.0.1"
+  }
+};
+
+// src/store.ts
+import { mkdir } from "fs/promises";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { JSONFilePreset } from "lowdb/node";
+async function createStore() {
+  const path = process.env.JOTJOT_DATA_FILE ?? join(homedir(), ".jotjot", "db.json");
+  await mkdir(dirname(path), { recursive: true });
+  return JSONFilePreset(path, { notes: [] });
+}
+
+// src/index.ts
+var ID_LENGTH = 8;
+function relativeTime(timestamp) {
+  const elapsed = Date.now() - new Date(timestamp).getTime();
+  const future = elapsed < 0;
+  const seconds = Math.round(Math.abs(elapsed) / 1e3);
+  if (seconds < 10) return "just now";
+  const units = [
+    ["year", 60 * 60 * 24 * 365],
+    ["month", 60 * 60 * 24 * 30],
+    ["week", 60 * 60 * 24 * 7],
+    ["day", 60 * 60 * 24],
+    ["hour", 60 * 60],
+    ["minute", 60],
+    ["second", 1]
+  ];
+  const formatter = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
+  for (const [unit, size] of units) {
+    if (seconds >= size) {
+      return formatter.format(
+        Math.round(seconds / size) * (future ? 1 : -1),
+        unit
+      );
+    }
+  }
+  return "just now";
+}
+function printNotes(notes) {
+  if (notes.length === 0) {
+    console.log(chalk.yellow("No notes found."));
+    return;
+  }
+  const timeWidth = Math.max(
+    ...notes.map((note) => relativeTime(note.createdAt).length)
+  );
+  for (const note of notes) {
+    console.log(
+      `${chalk.cyan(note.id)}  ${chalk.dim(relativeTime(note.createdAt).padEnd(timeWidth))}  ${note.text}`
+    );
+  }
+}
+function textFrom(words) {
+  return words.join(" ").trim();
+}
+function noteLabel(note) {
+  const text = note.text.length > 60 ? `${note.text.slice(0, 57)}...` : note.text;
+  return `${chalk.cyan(note.id)}  ${text}`;
+}
+async function resolveNote(notes, idPrefix) {
+  const exact = notes.find((note) => note.id === idPrefix);
+  if (exact) return exact;
+  const matches = notes.filter((note) => note.id.startsWith(idPrefix));
+  if (matches.length === 0) throw new Error(`Note ${idPrefix} was not found.`);
+  if (matches.length === 1) return matches[0];
+  return select({
+    message: `Multiple notes match \u201C${idPrefix}\u201D. Choose one:`,
+    choices: matches.map((note) => ({ name: noteLabel(note), value: note }))
+  });
+}
+var program = new Command();
+program.name("jot").description("Jot down a thought, fast.").version(package_default.version).showHelpAfterError();
+program.command("list").alias("ls").description("List notes, newest first").action(async () => {
+  const store = await createStore();
+  printNotes(
+    [...store.data.notes].sort(
+      (a, b) => b.createdAt.localeCompare(a.createdAt)
+    )
+  );
+});
+program.command("find").alias("f").description("Fuzzy-search notes").argument("<query...>", "words to find").action(async (query) => {
+  const store = await createStore();
+  const fuse = new Fuse(store.data.notes, {
+    keys: ["text"],
+    threshold: 0.5,
+    ignoreLocation: true
+  });
+  printNotes(fuse.search(textFrom(query)).map((result) => result.item));
+});
+program.command("edit").description("Edit a note").argument("<id>", "note ID").argument("[text...]", "replacement text").action(async (id, words) => {
+  const store = await createStore();
+  const note = await resolveNote(store.data.notes, id);
+  const suppliedText = textFrom(words);
+  const text = suppliedText || await input({ message: "Note:", default: note.text });
+  if (!text.trim()) throw new Error("A note cannot be empty.");
+  note.text = text.trim();
+  note.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+  await store.write();
+  console.log(
+    `${chalk.green("Updated")} ${chalk.dim("\xB7")} ${chalk.cyan(note.id)}`
+  );
+});
+program.command("remove").alias("rm").description("Remove a note").argument("<id>", "note ID").option("-f, --force", "skip confirmation").action(async (id, options) => {
+  const store = await createStore();
+  const note = await resolveNote(store.data.notes, id);
+  if (!options.force) {
+    const approved = await confirm({
+      message: `Remove \u201C${note.text}\u201D?`
+    });
+    if (!approved) {
+      console.log(chalk.yellow("Kept."));
+      return;
+    }
+  }
+  store.data.notes.splice(store.data.notes.indexOf(note), 1);
+  await store.write();
+  console.log(
+    `${chalk.green("Removed")} ${chalk.dim("\xB7")} ${chalk.cyan(note.id)}`
+  );
+});
+program.argument("[text...]", "note to create").action(async (words) => {
+  const text = textFrom(words);
+  if (!text) {
+    program.help();
+    return;
+  }
+  const store = await createStore();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const note = {
+    id: nanoid(ID_LENGTH),
+    text,
+    createdAt: now,
+    updatedAt: now
+  };
+  store.data.notes.push(note);
+  await store.write();
+  console.log(
+    `${chalk.green("Jotted")} ${chalk.dim("\xB7")} ${chalk.cyan(note.id)}`
+  );
+});
+
+// bin/app.ts
+program.parseAsync(process.argv).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(chalk2.red(message));
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "jotjot",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "jot": "dist/bin/app.js"
+  },
+  "main": "dist/bin/app.js",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/remvze/jotjot.git"
+  },
+  "homepage": "https://github.com/remvze/jotjot#readme",
+  "bugs": {
+    "url": "https://github.com/remvze/jotjot/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "lint:fix": "biome lint --write .",
+    "format": "biome format --write .",
+    "prepare": "husky",
+    "commit": "git-cz",
+    "release": "standard-version --no-verify",
+    "release:major": "pnpm run release --release-as major",
+    "release:minor": "pnpm run release --release-as minor",
+    "release:patch": "pnpm run release --release-as patch",
+    "build": "tsup-node",
+    "dev": "tsup-node --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "notes",
+    "note-taking",
+    "jot",
+    "terminal",
+    "productivity"
+  ],
+  "author": "Maze",
+  "license": "MIT",
+  "description": "A minimal CLI for quickly jotting down notes.",
+  "devDependencies": {
+    "@biomejs/biome": "2.0.6",
+    "@commitlint/cli": "19.8.1",
+    "@commitlint/config-conventional": "19.8.1",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/node": "^24.0.10",
+    "commitizen": "4.3.1",
+    "cz-conventional-changelog": "3.3.0",
+    "husky": "9.1.7",
+    "lint-staged": "16.1.2",
+    "standard-version": "9.5.0",
+    "tsup": "8.5.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "8.7.2",
+    "chalk": "6.0.0",
+    "commander": "14.0.0",
+    "fuse.js": "7.5.0",
+    "lowdb": "7.0.1",
+    "nanoid": "6.0.1"
+  }
+}