towles-tool

towles-tool CLI

Personal CLI toolkit. Alias: tt

Config: ~/.config/towles-tool/towles-tool.settings.json

Ralph (Autonomous Runner)

Ralph is a Claude Code autonomous runner built into tt for planning and executing tasks.'

It uses "plans" defined in markdown files and calls Claude Code to complete tasks iteratively in a headless manner.

Commands

# Plan management
tt ralph plan add "path.md"         # Add plan from file
tt ralph plan list                  # View plans
tt ralph plan done 1                # Mark complete
tt ralph plan remove 1              # Remove plan

# View
tt ralph show                       # Show plan with mermaid graph
tt ralph show --copy                # Copy to clipboard

# Execution
tt ralph run                        # Run (auto-commits by default)
tt ralph run --no-autoCommit        # No auto-commits
tt ralph run --planId 5             # Focus on specific plan
tt ralph run --maxIterations 20     # Limit iterations

Plan Files

Usally in docs/plans/{YYYY}-{MM}-{DD}-{plan-goal}.md

Git

tt gh branch        # Create branch from GitHub issue
tt gh pr            # Create pull request
tt gh branch-clean  # Delete merged branches

Journaling

tt journal daily-notes  # Weekly file, daily sections (alias: tt today)
tt journal meeting      # Meeting notes (alias: tt m)
tt journal note         # General notes (alias: tt n)

Utilities

tt config   # Show config (alias: cfg)
tt doctor   # Check dependencies
tt install  # Configure Claude Code settings