What is tyr?

Tyr is a TypeScript command line framework for building automation tools without writing repetitive setup code each time. Instead of keeping a pile of separate shell scripts and one-off Node utilities, Tyr gives every command a single typed context object that already has logging, error handling, and access to common services wired in, so you write one function and let the framework handle argument routing and documentation. You install it globally or as a project dependency with npm, then run a setup command that creates the expected folder structure. New commands are scaffolded with a single command that generates a TypeScript file and registers it in a YAML map. Each command file exports a function that receives a context object and returns the actual handler that runs when the command is called. The context object exposes a set of built in managers for common tasks: colored terminal logging, wrapping operations with error context, running shell commands, working with files and directories, managing npm packages, running Docker containers, git operations, system level utilities, querying an MSSQL database, and making web requests. A built in documentation command reads comments from these managers and serves a browsable reference locally. Tyr also supports importing commands other people have written and published. A manifest file lists command names alongside raw GitHub URLs to the TypeScript files that implement them, and Tyr can register a manifest, download its commands, and keep them in sync. Rules govern what happens when names collide: hand written commands are never overwritten by an import, only an explicit update command refreshes previously imported files, and if two imported modules define the same command name the one added most recently wins. Removing an imported module deletes only the files that module owns, leaving anything hand written or claimed by another module untouched. If a local folder is linked to a GitHub repository, Tyr can generate its own manifest file automatically so others can install your commands the same way. The project is written in TypeScript, requires Node 18 or newer, and is released under the MIT license.