@towles/tool 0.0.18 → 0.0.41

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Towles
+
+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/LICENSE.md

@@ -1,16 +1,13 @@
-MIT License
+# Proprietary License
 
-Copyright (c) 2025-PRESENT Chris Towles<https://github.com/ChrisTowles>
+Copyright (c) 2025 Chris Towles. All rights reserved.
 
-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:
+This software and associated documentation files (the "Software") are proprietary
+and confidential. Unauthorized copying, modification, distribution, or use of
+this Software, via any medium, is strictly prohibited.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+The Software is provided for the sole use of authorized individuals or entities
+who have been granted explicit written permission by the copyright holder.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
@@ -19,3 +16,5 @@ 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.
+
+For licensing inquiries, contact: Chris.Towles.Dev@gmail.com

package/README.md

@@ -1,116 +1,159 @@
 # Towles Tool
 
-[![npm version][npm-version-src]][npm-version-href]
-[![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![bundle][bundle-src]][bundle-href]
-[![JSDocs][jsdocs-src]][jsdocs-href]
-[![License][license-src]][license-href]
+Collection of quality-of-life tools and Claude Code plugins for daily development workflows.
 
-One off quality of life scripts that I use on a daily basis.
+## Overview
 
-## Journal Type System
+**CLI tool** (`tt`) - Distributed as a compiled Bun executable for daily development tasks.
 
-The journal system supports three types of files with different templates and organization:
+**Claude Code Plugin Marketplace** - Hosts Claude Code plugins for personal use.
 
-### Daily Notes (`journal daily-notes`)
-- **Purpose**: Weekly files with daily sections for ongoing work and notes
-- **File structure**: `YYYY/daily-notes/YYYY-MM-DD-week-log.md` (Monday's date)
-- **Template**: Includes sections for Monday through Friday with date headers
-- **Use case**: Regular daily journaling, work logs, scratch pad for notes
+The project evolved from a private toolbox of personal scripts to a compiled Bun executable and Claude Code plugin marketplace.
 
-### Meeting Files (`journal meeting [title]`)
-- **Purpose**: Structured meeting notes with agenda and action items
-- **File structure**: `YYYY/meetings/YYYY-MM-DD-HHMM-meeting-[title].md`
-- **Template**: Includes Date, Time, Attendees, Agenda, Notes, Action Items, and Follow-up sections
-- **Use case**: Meeting preparation, note-taking, and action item tracking
+## Installation
 
-### Note Files (`journal note [title]`)
-- **Purpose**: General-purpose notes with structured sections
-- **File structure**: `YYYY/notes/YYYY-MM-DD-HHMM-note-[title].md`
-- **Template**: Includes Summary, Details, and References sections
-- **Use case**: Research notes, documentation, general information capture
+### CLI Tool
 
-### Commands
-- `journal` or `journal daily-notes` - Create/open current week's daily notes
-- `journal meeting [title]` - Create a new meeting file with optional title
-- `journal note [title]` - Create a new note file with optional title
+Download the pre-built executable for your platform from [Releases](https://github.com/ChrisTowles/towles-tool/releases), or build from source:
 
-## Tools to add
-- [x] Journal system - creates and opens markdown files with templates for daily-notes, meetings, and notes
-- [ ] use claude code to generate git commits with multiple options for the commit message.
+```bash
+# Clone and build
+git clone https://github.com/ChrisTowles/towles-tool.git
+cd towles-tool
+bun install
+bun run build
+
+# The executable is at dist/tt
+# Move it somewhere in your PATH
+mv dist/tt ~/.local/bin/tt
+```
 
-## Install from repository
+### Claude Code Plugins
+
+Install plugins from this marketplace:
 
 ```bash
-pnpm add --global @towles/tool
+/plugins marketplace add ChrisTowles/towles-tool
+/plugin install tt@ChrisTowles/towles-tool
+```
 
-## followed by
-tt
+I do find myself editing `~/.claude/settings.json` a lot to directly modify settings around plugins.
+
+### Shell Completions
+
+Generate shell completions for tab completion support:
+
+```bash
+# Bash - add to ~/.bashrc
+tt completion >> ~/.bashrc
 
-# or
-towles-tool
+# Zsh - add to ~/.zshrc
+tt completion >> ~/.zshrc
+
+# Fish
+tt completion > ~/.config/fish/completions/tt.fish
 ```
 
-## Unisntall
+## Development
+
+### Setup
 
 ```bash
-pnpm remove --global @towles/tool
+# Clone the repository
+git clone https://github.com/ChrisTowles/towles-tool.git
+cd towles-tool
+bun install
 ```
 
-## If command not found
+### Commands
 
-try running with pnpm
 ```bash
-pnpm tt
+bun run start           # Run the CLI directly
+bun run build           # Build executable for current platform
+bun run build:all       # Build for all platforms (Linux, macOS, Windows)
+bun run test            # Run tests
+bun run lint            # Run linter
+bun run typecheck       # Type check
 ```
 
-if that works, then you need to add the pnpm global bin directory to your PATH.
-
-## packages to consider
-- [@anthropic-ai/claude-code](https://github.com/anthropic-ai/claude-code) - A library for interacting with the Claude code
-- [zod](https://github.com/colinhacks/zod) - TypeScript-first schema validation
-- [Consola](https://github.com/unjs/consola) console wrapper and colors
-- ~~[c12](https://github.com/unjs/c12) configuration loader and utilities~~
-    - referted stayed to json config
-- [rolldown-vite](https://voidzero.dev/posts/announcing-rolldown-vite) - A Vite plugin for rolling down your code
-- ~~[zx](https://github.com/google/zx) google created library to write shell scripts in a more powerful and expressive way via the Anthropic API.~~
-- [prompts](https://github.com/terkelg/prompts) - A library for creating beautiful command-line prompts, with fuzzy search and other features.
-  - had to patch it so `esc` cancels the selection with [pnpm-patch-i](https://github.com/antfu/pnpm-patch-i)
-- [yargs](https://github.com/yargs/yargs) - A modern, feature-rich command-line argument parser with enhanced error handling, TypeScript support, and flexible command configuration.
-- ~~[ink](https://github.com/vadimdemedes/ink) - React for interactive command-line apps~~
-    - wanted hotkey support and more complex UI but this was overkill for this project.
-- [publint](https://publint.dev/)
-- [e18e.dev](https://e18e.dev/guide/resources.html)
-
-## Document verbose and debug options
+### Plugin Validation
 
 ```bash
-export DEBUG=1
+claude plugin validate .  # Validate Claude Code plugins before publishing
 ```
 
-TODO add verbose option.
+**Plugin Marketplace**: `.claude-plugin/marketplace.json`
 
-## Development
+- Defines available plugins for installation
+
+### Releasing
+
+See [docs/releasing.md](./docs/releasing.md) for full details.
+
+```bash
+gh workflow run release.yml -f bump_type=patch  # or minor/major
+gh run watch  # monitor progress
+```
+
+## Reminders for me
+
+- Use plan mode!
+  - in plan mode tell claude your problems.
+  - in edit mode tell claude its problems.
+- use `/context` to see what is using context and if you need to trim anything down.
+  - Only add context Claude doesn't already have but needs
+- Always write in third person for prompts
+- use a tool to write your prompts and evaluate them.
+  - These models are smart. Less is more. don't be too verbose
+  - https://console.anthropic.com/workbench/
+- read source code from primary sources like:
+  - [anthropic repos](https://github.com/anthropics)
+- [Skills best practices](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices#core-principles)
+  - gerund form (verb + -ing) for skill names
+- [claude cookbook skills section](https://github.com/anthropics/claude-cookbooks/tree/main/skills)
+- https://github.com/anthropics/skills
+  - installed as a plugin, has examples and skill-creator
+
+```bash
+/plugin marketplace add anthropics/skills
+```
+
+## Roadmap
+
+### Planned Features
+
+**Journal Type System**:
 
-For information on how releases are managed, see the [Release Process](docs/release-process.md) documentation.
+- [ ] daily-notes
+- [ ] meeting
+- [ ] note
+- [ ] task (todo)
+
+**Git Tools**:
+
+- [ ] commit-message-generator
+- [ ] pull-request-generator
+- [ ] issue-generator
+- [ ] pull-request-reviewer
+- [ ] branch-from-issue
+
+## Resources
+
+### Claude Code Plugin Development
+
+- [Claude Code Plugins Announcement](https://www.anthropic.com/news/claude-code-plugins)
+- [Official Claude Code Plugins](https://github.com/anthropics/claude-code/tree/main/plugins)
+- [Skills Guide](https://docs.claude.com/en/api/skills-guide)
+- [Best Practices](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/best-practices)
+
+### Project Documentation
+
+- [Node Package](./docs/node-package.md) - How the repo worked when it was a node package
 
 ## History
 
-I'm using a lot of inspiration from [Anthony Fu](https://github.com/antfu) for this projects codebase.
+This project started as a collection of personal scripts and utilities built up over time in a private toolbox. It was initially published as an npm package, but has since evolved to be distributed as a compiled Bun executable. With the release of Claude Code Skills and plugins, the project also serves as a Claude Code plugin marketplace.
 
 ## License
 
 [MIT](./LICENSE) License © [Chris Towles](https://github.com/ChrisTowles)
-
-<!-- Badges -->
-
-[npm-version-src]: https://img.shields.io/npm/v/@towles/tool?style=flat&colorA=080f12&colorB=1fa669
-[npm-version-href]: https://npmjs.com/package/@towles/tool
-[npm-downloads-src]: https://img.shields.io/npm/dm/@towles/tool?style=flat&colorA=080f12&colorB=1fa669
-[npm-downloads-href]: https://npmjs.com/package/@towles/tool
-[bundle-src]: https://img.shields.io/bundlephobia/minzip/@towles/tool?style=flat&colorA=080f12&colorB=1fa669&label=minzip
-[bundle-href]: https://bundlephobia.com/result?p=@towles/tool
-[license-src]: https://img.shields.io/github/license/ChrisTowles/towles-tool.svg?style=flat&colorA=080f12&colorB=1fa669
-[license-href]: https://github.com/ChrisTowles/towles-tool/blob/main/LICENSE.md
-[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
-[jsdocs-href]: https://www.jsdocs.io/package/@towles/tool

package/bin/run.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env tsx
+
+import { execute } from "@oclif/core";
+
+await execute({ dir: import.meta.url });

package/package.json

@@ -1,91 +1,101 @@
 {
   "name": "@towles/tool",
-  "type": "module",
-  "version": "0.0.18",
+  "version": "0.0.41",
   "description": "One off quality of life scripts that I use on a daily basis.",
-  "author": "Chris Towles <Chris.Towles.Dev@gmail.com>",
-  "license": "MIT",
-  "funding": {
-    "url": "https://github.com/sponsors/ChrisTowles"
-  },
   "homepage": "https://github.com/ChrisTowles/towles-tool#readme",
+  "bugs": {
+    "url": "https://github.com/ChrisTowles/towles-tool/issues"
+  },
+  "license": "MIT",
+  "author": "Chris Towles <Chris.Towles.Dev@gmail.com>",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ChrisTowles/towles-tool.git"
   },
-  "bugs": {
-    "url": "https://github.com/ChrisTowles/towles-tool/issues"
-  },
-  "keywords": [],
-  "sideEffects": false,
-  "exports": {
-    ".": "./dist/index.mjs",
-    "./package.json": "./package.json"
+  "funding": {
+    "url": "https://github.com/sponsors/ChrisTowles"
   },
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
   "bin": {
-    "towles-tool": "./dist/index.mjs",
-    "tt": "./dist/index.mjs"
+    "towles-tool": "./bin/run.ts",
+    "tt": "./bin/run.ts"
   },
   "files": [
-    "dist"
+    "bin",
+    "patches",
+    "src"
   ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "version:sync": "pnpm tsx scripts/sync-versions.ts",
+    "prepublishOnly": "pnpm run version:sync",
+    "start": "tsx bin/run.ts",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "test": "vitest run",
+    "test:watch": "CI=DisableCallingClaude vitest watch",
+    "typecheck": "tsgo --noEmit --incremental",
+    "prepare": "simple-git-hooks"
+  },
   "dependencies": {
-    "@anthropic-ai/claude-code": "^1.0.51",
+    "@anthropic-ai/claude-code": "^2.1.4",
     "@anthropic-ai/sdk": "^0.56.0",
-    "@clack/prompts": "^0.11.0",
-    "comment-json": "^4.2.5",
+    "@oclif/core": "^4.3.2",
     "consola": "^3.4.2",
+    "d3-hierarchy": "^3.1.2",
     "fzf": "^0.5.2",
     "luxon": "^3.7.1",
     "neverthrow": "^8.2.0",
+    "picocolors": "^1.1.1",
     "prompts": "^2.4.2",
     "strip-ansi": "^7.1.0",
     "tinyexec": "^0.3.2",
-    "yargs": "^17.7.2",
     "zod": "^4.0.5"
   },
   "devDependencies": {
-    "@antfu/ni": "^25.0.0",
+    "@oclif/test": "^4.1.10",
+    "@types/d3-hierarchy": "^3.1.7",
     "@types/luxon": "^3.6.2",
     "@types/node": "^22.16.3",
     "@types/prompts": "^2.4.9",
-    "@types/yargs": "^17.0.32",
-    "bumpp": "^10.2.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260111.1",
+    "bumpp": "^10.4.0",
     "lint-staged": "^15.5.2",
+    "oxfmt": "^0.24.0",
     "oxlint": "^1.7.0",
     "simple-git-hooks": "^2.13.0",
-    "tsx": "^4.20.3",
+    "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "unbuild": "^3.5.0",
-    "vite": "^6.3.5",
-    "vitest": "^3.2.4",
-    "vitest-package-exports": "^0.1.1",
-    "yaml": "^2.8.0"
+    "vitest": "^4.0.17"
   },
   "simple-git-hooks": {
-    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+    "pre-commit": "pnpm exec lint-staged -q && claude plugin validate ."
   },
   "lint-staged": {
-    "*": "oxlint --fix"
+    "*.{js,ts,jsx,tsx,json,md}": "oxfmt --write",
+    "*": "oxlint --quiet --fix"
   },
-  "directories": {
-    "test": "test"
+  "oclif": {
+    "bin": "tt",
+    "commands": {
+      "identifier": "default",
+      "strategy": "explicit",
+      "target": "./src/commands/index.ts"
+    },
+    "dirname": "towles-tool",
+    "topicSeparator": " "
   },
-  "scripts": {
-    "build": "unbuild",
-    "dev": "unbuild --stub",
-    "lint": "oxlint",
-    "lint:fix": "oxlint --fix",
-    "lint:fix_all": "oxlint --fix .",
-    "lint:package": "pnpm dlx publint --fix && pnpm dlx knip",
-    "release:local": "bumpp && pnpm publish --no-git-checks -r --access public",
-    "release": "bumpp && echo \"github action will run and publish to npm\"",
-    "start": "tsx src/index.ts",
-    "test": "vitest --run",
-    "test:watch": "CI=DisableCallingClaude vitest --watch",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  "packageManager": "pnpm@10.27.0",
+  "pnpm": {
+    "patchedDependencies": {
+      "prompts@2.4.2": "patches/prompts.patch"
+    }
+  },
+  "trustedDependencies": [
+    "@anthropic-ai/claude-code"
+  ]
+}

package/patches/prompts.patch

@@ -0,0 +1,34 @@
+# prompts patch
+#
+# Used by: src/commands/gh/branch.ts (autocomplete with fzf fuzzy filtering)
+#
+# Fix: On exit (Ctrl+C/Ctrl+D), reject the promise instead of resolving.
+# Without this, exiting a prompt resolves with undefined and code continues
+# as if user submitted empty input. This lets us catch cancellation properly.
+
+diff --git a/dist/prompts.js b/dist/prompts.js
+index 31f2648a7d215d61aff736424a6f2d66d07e3273..2b8a0ac36fd22ed17f6096ce4f52a4db95ba2633 100644
+--- a/dist/prompts.js
++++ b/dist/prompts.js
+@@ -14,7 +14,7 @@ function toPrompt(type, args, opts = {}) {
+     const onExit = opts.onExit || noop;
+     p.on('state', args.onState || noop);
+     p.on('submit', x => res(onSubmit(x)));
+-    p.on('exit', x => res(onExit(x)));
++    p.on('exit', x => rej(onExit(x)));
+     p.on('abort', x => rej(onAbort(x)));
+   });
+ }
+diff --git a/lib/prompts.js b/lib/prompts.js
+index 9f625564601da8f79040698de197a6ff2fec3859..e08923fc9f66ab0700788a62455da89ad23c5f35 100644
+--- a/lib/prompts.js
++++ b/lib/prompts.js
+@@ -11,7 +11,7 @@ function toPrompt(type, args, opts={}) {
+     const onExit = opts.onExit || noop;
+     p.on('state', args.onState || noop);
+     p.on('submit', x => res(onSubmit(x)));
+-    p.on('exit', x => res(onExit(x)));
++    p.on('exit', x => rej(onExit(x)));
+     p.on('abort', x => rej(onAbort(x)));
+   });
+ }

package/src/commands/base.ts

@@ -0,0 +1,42 @@
+import { Command, Flags } from "@oclif/core";
+import { LoadedSettings, loadSettings } from "../config/settings.js";
+
+/**
+ * Base command that all towles-tool commands extend.
+ * Provides shared functionality like settings loading and debug flag.
+ */
+export abstract class BaseCommand extends Command {
+  static baseFlags = {
+    debug: Flags.boolean({
+      char: "d",
+      description: "Enable debug output",
+      default: false,
+    }),
+  };
+
+  protected settings!: LoadedSettings;
+
+  /**
+   * Called before run(). Loads user settings.
+   */
+  async init(): Promise<void> {
+    await super.init();
+    this.settings = await loadSettings();
+  }
+
+  /**
+   * Helper to log debug messages when --debug flag is set.
+   */
+  protected logDebug(message: string, ...args: unknown[]): void {
+    // Access flags via parse() - oclif guarantees flags exist after init()
+    void (this.parse as () => Promise<{ flags: { debug?: boolean } }>)()
+      .then((parsed) => {
+        if (parsed.flags?.debug) {
+          this.log(`[DEBUG] ${message}`, ...args);
+        }
+      })
+      .catch(() => {
+        /* ignore parse errors in debug logging */
+      });
+  }
+}

package/src/commands/config.test.ts

@@ -0,0 +1,15 @@
+/**
+ * Integration tests for oclif config command
+ * Note: consola outputs to stderr with different log levels
+ */
+import { describe, it, expect } from "vitest";
+import { runCommand } from "@oclif/test";
+
+describe("config command", () => {
+  it("runs config and outputs settings info", async () => {
+    const { stderr } = await runCommand(["config"]);
+    // consola.warn outputs captured in stderr
+    expect(stderr).toContain("User Config");
+    expect(stderr).toContain("Working Directory");
+  });
+});

package/src/commands/config.ts

@@ -0,0 +1,43 @@
+import consola from "consola";
+import { BaseCommand } from "./base.js";
+
+/**
+ * Display current configuration settings
+ */
+export default class Config extends BaseCommand {
+  static override description = "Display current configuration settings";
+
+  static override examples = ["<%= config.bin %> <%= command.id %>", "<%= config.bin %> cfg"];
+
+  async run(): Promise<void> {
+    await this.parse(Config);
+
+    consola.info("Configuration");
+    consola.log("");
+
+    consola.info(`Settings File: ${this.settings.settingsFile.path}`);
+    consola.log("");
+
+    consola.warn("User Config:");
+    consola.log(
+      `  Daily Path Template: ${this.settings.settingsFile.settings.journalSettings.dailyPathTemplate}`,
+    );
+    consola.log(
+      `  Meeting Path Template: ${this.settings.settingsFile.settings.journalSettings.meetingPathTemplate}`,
+    );
+    consola.log(
+      `  Note Path Template: ${this.settings.settingsFile.settings.journalSettings.notePathTemplate}`,
+    );
+    consola.log(`  Editor: ${this.settings.settingsFile.settings.preferredEditor}`);
+    consola.log("");
+
+    consola.warn("Working Directory:");
+    consola.log(`  ${process.cwd()}`);
+    consola.log("");
+
+    consola.info("Shell Completions:");
+    consola.log("  Run `tt completion` to generate shell completions");
+    consola.log("  Bash/Zsh: tt completion >> ~/.bashrc (or ~/.zshrc)");
+    consola.log("  Fish: tt completion > ~/.config/fish/completions/tt.fish");
+  }
+}