towles-tool

Automate Claude Code task planning and execution via the tt CLI.

Updated Jul 2, 2026

Search Tags:#automation #claude-code #cli-tool #autonomous #plan-management #towles-tool #markdown-plans

Ready to run

npx skills add https://github.com/ChrisTowles/towles-tool --skill towles-tool

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: towles-tool
Source: https://github.com/ChrisTowles/towles-tool/tree/main/plugins/tt-core/skills/towles-tool
Command: npx skills add https://github.com/ChrisTowles/towles-tool --skill towles-tool

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

towles-tool provides a headless autonomous runner to orchestrate Claude Code tasks by planning and executing tasks using the tt CLI.

Core Features & Use Cases

Plan management: add, list, mark done, and remove plans.
View and execution: show plans with mermaid graphs and run plans with optional planId or maxIterations.
Plan files & organization: supports markdown plan files under docs/plans for repository-wide planning.
Git, journaling, and utilities: integrates with Git, supports journaling commands, and provides config/doctor/install utilities.

Quick Start

Install towles-tool, create your first plan markdown under docs/plans, and run tt ralph to execute it.

Frequently Asked Questions about towles-tool

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate Claude Code tasks with markdown plans?▼

You can automate Claude Code tasks by defining markdown plan files under docs/plans and using the tt CLI to orchestrate execution. The runner applies these plans against Claude Code to manage autonomous task execution.

What is the best way to manage autonomous plans for Claude Code?▼

Plan management for autonomous Claude Code execution is handled through the tt CLI, which allows you to add, list, mark done, and remove plans. Plans are organized as markdown files within your repository.

How do I execute a specific plan in Claude Code using tt?▼

To execute a plan, run the tt ralph command with an optional planId or maxIterations parameter. This triggers the autonomous runner to process your defined markdown plan against the Claude Code environment.

Do I need a specific environment setup to run towles-tool plans?▼

Yes, running towles-tool requires a configured environment with the tt alias, markdown plan files, and access to Claude Code. You can use the doctor and install utilities to verify and set up your configuration.

Can I visualize task plans before executing them in Claude Code?▼

Yes, you can view plans with automatically generated mermaid graphs using the tt CLI. This allows you to visualize the structure of your markdown plans before autonomous execution.