toha 0.4.2

Generate projects and files from templates through one interview for people, scripts, agents, and Rust callers.
Documentation

Toha

Generate projects and files from templates.

CI Latest release

Toha terminal demo

Toha is a project scaffolding tool and Rust library. Templates ask questions, then render file paths and contents with Jinja. Preview the plan before writing.

  • Use the same interview from a terminal, scripts, agents, or Rust.
  • Resume interviews and supply headless answers, including document answers.
  • Keep application inputs and file ownership in a committed .toha.json record.
  • Select template parts and update generated projects while preserving edits.
  • Render typed Jinja values, file paths, loops, and static files.
  • Reserve user-editable sections inside generated files.
  • Create empty directories with rendered paths and optional loops.
  • Use Git templates, short names, aliases, and hooks gated by trust.
  • Read embedded agent guidance with toha skills.

Read the Toha documentation for detailed guides.

Install

With Homebrew on macOS or Linux:

brew install wyrd-company/tools/toha

See installation methods for other platforms.

First run

Toha includes an offline demo template:

toha apply toha-demo ./notes

Answer Note title and Topic. To preview without writing, run toha apply toha-demo ./preview --dry-run.

Use from Rust

Use Toha without CLI dependencies to run interviews, manage templates, and apply or update projects. See Using Toha from Rust for the dependency, session flow, and a complete consumer example.

See CONTRIBUTING.md for development and changes.