Towles Tool

One off quality of life scripts that I use on a daily basis.

Journal Type System

The journal system supports three types of files with different templates and organization:

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

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

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

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

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.

Install from repository

pnpm add --global @towles/tool

## followed by
tt

# or
towles-tool

Unisntall

pnpm remove --global @towles/tool

If command not found

try running with pnpm

pnpm tt

if that works, then you need to add the pnpm global bin directory to your PATH.

packages to consider

• @anthropic-ai/claude-code - A library for interacting with the Claude code
• zod - TypeScript-first schema validation
• Consola console wrapper and colors
• c12 configuration loader and utilities
  • referted stayed to json config
• rolldown-vite - A Vite plugin for rolling down your code
• zx google created library to write shell scripts in a more powerful and expressive way via the Anthropic API.
• prompts - A library for creating beautiful command-line prompts, with fuzzy search and other features.
• yargs - A modern, feature-rich command-line argument parser with enhanced error handling, TypeScript support, and flexible command configuration.
• ink - React for interactive command-line apps
  • wanted hotkey support and more complex UI but this was overkill for this project.
• publint
• e18e.dev

Document verbose and debug options

export DEBUG=1

TODO add verbose option.

Development

For information on how releases are managed, see the Release Process documentation.

History

I'm using a lot of inspiration from Anthony Fu for this projects codebase.

License

MIT License © Chris Towles