Docs/CLI reference

CLI reference

tama install

Installs Tama-managed user-global Git dispatchers for pre-commit and pre-push, preserving a pre-existing unmanaged hook once as .before-tama.

Installs Tama-managed user-global Git dispatchers for pre-commit and pre-push, preserving a pre-existing unmanaged hook once as .before-tama.

#Invocation

tama install [--git-hooks-path <path>] [--home <path>]
             [--set-git-config] [--no-git-config] [--json]

--git-hooks-path chooses the dispatcher directory. Otherwise Tama uses global core.hooksPath, falling back to ~/.config/git/hooks. --home controls home expansion and the Git configuration environment. --set-git-config writes global core.hooksPath; --no-git-config wins when both flags are present. --json selects structured output.

#Output and state

Tama creates the hooks directory, writes executable managed dispatchers, and may create pre-commit.before-tama and pre-push.before-tama. Output names the resolved hooks path, both installed targets and whether Git global configuration changed.

#Refusals and failures

Filesystem and process errors are written to stderr and exit 1. When requested Git configuration returns nonzero, Tama reports Git's stderr, or exactly git config failed when Git produced no message. Without --set-git-config, the command deliberately leaves Git configuration untouched.

Return to the complete CLI command tree.