mem-terminal 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Siddhartha Lingampalli
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21
+ DEALINGS IN THE SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,87 @@
1
+ # mem
2
+
3
+ Never lose a terminal command again. Search your PowerShell history instantly using keywords and fuzzy search. No cloud. No setup.
4
+
5
+ ```bash
6
+ mem "docker compose"
7
+ # → Found 3 matching commands
8
+ # 1. docker compose up -d
9
+ # 2. docker compose down
10
+ # 3. docker compose logs
11
+ ```
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ npm install -g @siddu-lingampelli/mem-search
17
+ ```
18
+
19
+ ## Usage
20
+
21
+ ```bash
22
+ mem "docker compose" # direct search
23
+ mem search "docker compose" # explicit subcommand
24
+ mem --help # show help
25
+ mem --version # show version
26
+ ```
27
+
28
+ Fuzzy matching works with typos, partial words, and any case:
29
+
30
+ ```bash
31
+ mem "docer" # fuzzy → finds docker
32
+ mem "DOCKER" # case insensitive
33
+ mem " docker " # spaces trimmed
34
+ mem "" # → friendly error
35
+ ```
36
+
37
+ ## How it works
38
+
39
+ Reads your PSReadLine history (`ConsoleHost_history.txt`), newest-first.
40
+ Detects UTF-8 and UTF-16 LE BOM automatically.
41
+ Searches with Fuse.js (threshold 0.6, min match length 2).
42
+ Formats results with ANSI highlights (respects `NO_COLOR` env var).
43
+
44
+ **Search engine config:**
45
+
46
+ ```typescript
47
+ const fuse = new Fuse(entries, {
48
+ keys: ["command"],
49
+ includeScore: true,
50
+ threshold: 0.6,
51
+ minMatchCharLength: 2,
52
+ });
53
+ ```
54
+
55
+ ## Requirements
56
+
57
+ - Windows + PowerShell (PSReadLine history)
58
+ - Node.js 18+
59
+
60
+ ## Roadmap
61
+
62
+ - **V1** ✅ — PowerShell history search, fuzzy matching
63
+ - **V2** — Indexed search, Bash/Zsh/Fish support, sync, stats
64
+
65
+ ## Development
66
+
67
+ ```bash
68
+ npm install
69
+ npm run build # tsc
70
+ npm test # vitest run (13 tests)
71
+ npm run dev # tsx src/cli.ts
72
+ ```
73
+
74
+ Override history file for testing:
75
+
76
+ ```bash
77
+ $env:PSREADLINE_HISTORY_FILE = ".\test_history.txt"
78
+ node dist/cli.js "docker"
79
+ ```
80
+
81
+ ## License
82
+
83
+ MIT — see [LICENSE](LICENSE).
84
+
85
+ ---
86
+
87
+ Built by [Siddhartha Lingampalli](https://github.com/Siddu-lingampelli).
package/dist/cli.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/cli.js ADDED
@@ -0,0 +1,139 @@
1
+ #!/usr/bin/env node
2
+ import { program, Command } from "commander";
3
+ import { readHistory } from "./history.js";
4
+ import { search } from "./search.js";
5
+ import { print, useColor } from "./output.js";
6
+ const RESET = "\x1b[0m";
7
+ const BOLD = "\x1b[1m";
8
+ const DIM = "\x1b[2m";
9
+ const CYAN = "\x1b[36m";
10
+ const VERSION = "1.0.0";
11
+ function stripAnsi(text) {
12
+ return text.replace(/\x1b\[\d+m/g, "");
13
+ }
14
+ function paint(text) {
15
+ return useColor() ? text : stripAnsi(text);
16
+ }
17
+ function runSearch(query) {
18
+ try {
19
+ const entries = readHistory();
20
+ if (entries.length === 0) {
21
+ console.error("No history found.");
22
+ process.exit(1);
23
+ }
24
+ const results = search(entries, query);
25
+ if (results.length === 0) {
26
+ console.log("No matching commands found.");
27
+ return;
28
+ }
29
+ print(results, query);
30
+ }
31
+ catch (err) {
32
+ console.error("Error reading history:", err.message);
33
+ process.exit(1);
34
+ }
35
+ }
36
+ // Custom help formatter
37
+ function customHelp() {
38
+ const header = paint([
39
+ `${BOLD}${CYAN}mem${RESET} v${VERSION}`,
40
+ "",
41
+ "Search your terminal history instantly."
42
+ ].join("\n"));
43
+ const usage = paint([
44
+ `${DIM}Usage${RESET}`,
45
+ `${BOLD}mem${RESET} <query>`,
46
+ `${BOLD}mem${RESET} ${BOLD}search${RESET} <query>`
47
+ ].join("\n"));
48
+ const commands = paint([
49
+ `${DIM}Commands${RESET}`,
50
+ `${BOLD}search${RESET} <query> Search your terminal history`,
51
+ `${BOLD}index${RESET} ${DIM}(coming in V2)${RESET}`,
52
+ `${BOLD}sync${RESET} ${DIM}(coming in V2)${RESET}`,
53
+ `${BOLD}stats${RESET} ${DIM}(coming in V2)${RESET}`
54
+ ].join("\n"));
55
+ const examples = paint([
56
+ `${DIM}Examples${RESET}`,
57
+ `${BOLD}mem${RESET} "docker compose"`,
58
+ `${BOLD}mem${RESET} "git rebase -i"`,
59
+ `${BOLD}mem search${RESET} "npm run build"`
60
+ ].join("\n"));
61
+ const options = paint([
62
+ `${DIM}Options${RESET}`,
63
+ `${BOLD}-V, --version${RESET} output the version number`,
64
+ `${BOLD}-h, --help${RESET} display help for command`,
65
+ ].join("\n"));
66
+ return `${header}
67
+
68
+ ${usage}
69
+
70
+ ${commands}
71
+
72
+ ${examples}
73
+
74
+ ${options}`;
75
+ }
76
+ const searchCmd = new Command("search");
77
+ searchCmd
78
+ .argument("<query>", "Search query")
79
+ .description("Search your terminal history")
80
+ .action((query) => runSearch(query));
81
+ // Stub commands for V2 preview
82
+ function stub(name) {
83
+ const cmd = new Command(name);
84
+ cmd.description(`${name} command (coming in V2)`);
85
+ cmd.action(() => {
86
+ console.error(`'mem ${name}' is coming in V2. Only 'mem search' is available in V1.`);
87
+ process.exit(1);
88
+ });
89
+ return cmd;
90
+ }
91
+ program
92
+ .name("mem")
93
+ .addCommand(searchCmd)
94
+ .addCommand(stub("index"))
95
+ .addCommand(stub("sync"))
96
+ .addCommand(stub("stats"))
97
+ .argument("[query]", "Search query")
98
+ .action((query) => {
99
+ if (query === undefined) {
100
+ program.outputHelp();
101
+ return;
102
+ }
103
+ runSearch(query);
104
+ });
105
+ // Override the default help information
106
+ program.helpInformation = () => paint(customHelp());
107
+ // Handle --version and -V with custom formatting via pre-parse scan.
108
+ // This runs before Commander processes subcommand args, so there's no
109
+ // hijacking risk — Commander never sees the flag.
110
+ program.exitOverride();
111
+ const idx = process.argv.indexOf("--version");
112
+ const idxShort = process.argv.indexOf("-V");
113
+ if (idx > 0 || idxShort > 0) {
114
+ console.log(paint([
115
+ `${CYAN}${BOLD}mem${RESET} ${DIM}v${VERSION}${RESET}`,
116
+ `${DIM}Search your terminal history instantly.${RESET}`,
117
+ ].join("\n")));
118
+ process.exit(0);
119
+ }
120
+ // Suppress Commander's help-throws-after-display noise
121
+ try {
122
+ program.parse();
123
+ }
124
+ catch (e) {
125
+ const code = e?.code;
126
+ if (code === "commander.helpDisplayed") {
127
+ process.exit(0);
128
+ }
129
+ if (code === "commander.missingArgument" ||
130
+ code === "commander.unknownOption" ||
131
+ code === "commander.unknownCommand" ||
132
+ code === "commander.missingArgumentForCommand") {
133
+ console.error(paint(`${DIM}Error:${RESET} ${e.message}`));
134
+ program.outputHelp();
135
+ process.exit(1);
136
+ }
137
+ throw e;
138
+ }
139
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { HistoryEntry } from "./types.js";
2
+ export declare function readHistory(limit?: number): HistoryEntry[];
@@ -0,0 +1,36 @@
1
+ import { readFileSync, existsSync } from "fs";
2
+ import { getHistoryFilePath } from "./utils.js";
3
+ /**
4
+ * Detects BOM (Byte Order Mark) in buffer and returns the appropriate encoding.
5
+ * Returns the correct encoding for UTF-8 BOM, UTF-16 LE BOM, or defaults to utf-8.
6
+ */
7
+ function detectEncoding(buffer) {
8
+ // UTF-8 BOM: EF BB BF
9
+ if (buffer.length >= 3 && buffer[0] === 0xEF && buffer[1] === 0xBB && buffer[2] === 0xBF) {
10
+ return "utf8";
11
+ }
12
+ // UTF-16 LE BOM: FF FE
13
+ if (buffer.length >= 2 && buffer[0] === 0xFF && buffer[1] === 0xFE) {
14
+ return "utf16le";
15
+ }
16
+ return "utf-8";
17
+ }
18
+ export function readHistory(limit = 2000) {
19
+ const path = getHistoryFilePath();
20
+ if (!existsSync(path)) {
21
+ return [];
22
+ }
23
+ const buffer = readFileSync(path);
24
+ const encoding = detectEncoding(buffer);
25
+ const raw = buffer.toString(encoding);
26
+ const lines = raw.split(/\r?\n/);
27
+ const entries = [];
28
+ for (let i = lines.length - 1; i >= 0 && entries.length < limit; i--) {
29
+ const cmd = lines[i].trim();
30
+ if (cmd.length > 0) {
31
+ entries.push({ command: cmd });
32
+ }
33
+ }
34
+ return entries;
35
+ }
36
+ //# sourceMappingURL=history.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,sBAAsB;IACtB,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,uBAAuB;IACvB,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAK,GAAG,IAAI;IACtC,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { SearchResult } from "./types.js";
2
+ export declare function useColor(): boolean;
3
+ export declare function dim(text: string): string;
4
+ export declare function print(results: SearchResult[], query: string): void;
package/dist/output.js ADDED
@@ -0,0 +1,53 @@
1
+ const RESET = "\x1b[0m";
2
+ const DIM = "\x1b[2m";
3
+ const MAGENTA = "\x1b[35m";
4
+ export function useColor() {
5
+ if (process.env.NO_COLOR !== undefined)
6
+ return false;
7
+ return process.stdout.isTTY === true;
8
+ }
9
+ function color(text) {
10
+ return `${MAGENTA}${text}${RESET}`;
11
+ }
12
+ export function dim(text) {
13
+ return `${DIM}${text}${RESET}`;
14
+ }
15
+ function escapeRegExp(str) {
16
+ return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
17
+ }
18
+ function buildHighlightRegex(query) {
19
+ const trimmed = query.trim();
20
+ if (trimmed.length === 0)
21
+ return null;
22
+ const pattern = trimmed.split(/\s+/).filter(Boolean).map(escapeRegExp).join("|");
23
+ if (pattern.length === 0)
24
+ return null;
25
+ return new RegExp(`(${pattern})`, "gi");
26
+ }
27
+ function highlight(command, regex) {
28
+ if (!regex)
29
+ return command;
30
+ if (useColor()) {
31
+ return command.replace(regex, color("$1"));
32
+ }
33
+ return command;
34
+ }
35
+ export function print(results, query) {
36
+ if (results.length === 0) {
37
+ console.log("No matching commands found.");
38
+ return;
39
+ }
40
+ const plural = results.length === 1 ? "command" : "commands";
41
+ console.log(`\nFound ${results.length} matching ${plural}\n`);
42
+ const regex = buildHighlightRegex(query);
43
+ const applyDim = useColor() ? dim : (s) => s;
44
+ const sep = applyDim("--------------------------------");
45
+ for (let i = 0; i < results.length; i++) {
46
+ const r = results[i];
47
+ const rank = applyDim(`${i + 1}.`);
48
+ const hl = highlight(r.command, regex);
49
+ console.log(`${rank}\n\n${hl}`);
50
+ console.log(`${sep}\n`);
51
+ }
52
+ }
53
+ //# sourceMappingURL=output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { HistoryEntry, SearchResult } from "./types.js";
2
+ export declare function search(entries: HistoryEntry[], query: string): SearchResult[];
package/dist/search.js ADDED
@@ -0,0 +1,19 @@
1
+ import Fuse from "fuse.js";
2
+ export function search(entries, query) {
3
+ const normalized = query.trim();
4
+ if (normalized.length === 0) {
5
+ return [];
6
+ }
7
+ const fuse = new Fuse(entries, {
8
+ keys: ["command"],
9
+ includeScore: true,
10
+ threshold: 0.6,
11
+ minMatchCharLength: 2,
12
+ });
13
+ const results = fuse.search(normalized);
14
+ return results.map((r) => ({
15
+ command: r.item.command,
16
+ score: r.score ?? 1,
17
+ }));
18
+ }
19
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B,MAAM,UAAU,MAAM,CAAC,OAAuB,EAAE,KAAa;IAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE;QAC7B,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,GAAG;QACd,kBAAkB,EAAE,CAAC;KACtB,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;QACvB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KACpB,CAAC,CAAC,CAAC;AACN,CAAC"}
@@ -0,0 +1,7 @@
1
+ export interface HistoryEntry {
2
+ command: string;
3
+ }
4
+ export interface SearchResult {
5
+ command: string;
6
+ score: number;
7
+ }
package/dist/types.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Returns the path to the PSReadLine history file.
3
+ * Checks the env var first (if set and non-empty), then tries
4
+ * PowerShell 7 location, then falls back to Windows PowerShell 5.1.
5
+ */
6
+ export declare function getHistoryFilePath(): string;
package/dist/utils.js ADDED
@@ -0,0 +1,16 @@
1
+ import { homedir } from "os";
2
+ import { join } from "path";
3
+ /**
4
+ * Returns the path to the PSReadLine history file.
5
+ * Checks the env var first (if set and non-empty), then tries
6
+ * PowerShell 7 location, then falls back to Windows PowerShell 5.1.
7
+ */
8
+ export function getHistoryFilePath() {
9
+ const envPath = process.env.PSREADLINE_HISTORY_FILE;
10
+ if (envPath && envPath.length > 0) {
11
+ return envPath;
12
+ }
13
+ const home = homedir();
14
+ return join(home, "AppData", "Roaming", "Microsoft", "PowerShell", "PSReadLine", "ConsoleHost_history.txt");
15
+ }
16
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACpD,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,yBAAyB,CAAC,CAAC;AAC9G,CAAC"}
package/package.json ADDED
@@ -0,0 +1,39 @@
1
+ {
2
+ "name": "mem-terminal",
3
+ "version": "1.0.0",
4
+ "description": "Search your terminal history instantly. Fuzzy search for PowerShell/PSReadLine history.",
5
+ "type": "module",
6
+ "bin": {
7
+ "mem": "dist/cli.js"
8
+ },
9
+ "scripts": {
10
+ "build": "tsc",
11
+ "start": "node dist/cli.js",
12
+ "dev": "tsx src/cli.ts",
13
+ "test": "vitest run",
14
+ "test:watch": "vitest",
15
+ "prepublishOnly": "npm run build"
16
+ },
17
+ "keywords": [
18
+ "cli",
19
+ "history",
20
+ "powershell",
21
+ "search"
22
+ ],
23
+ "license": "MIT",
24
+ "dependencies": {
25
+ "commander": "^13.0.0",
26
+ "fuse.js": "^7.1.0"
27
+ },
28
+ "devDependencies": {
29
+ "@types/node": "^22.0.0",
30
+ "typescript": "^5.7.0",
31
+ "tsx": "^4.19.0",
32
+ "vitest": "^3.0.0"
33
+ },
34
+ "files": [
35
+ "dist",
36
+ "README.md",
37
+ "LICENSE"
38
+ ]
39
+ }