TTama
Docs/CLI reference

CLI reference

tama adaptive install

Replaces the legacy shared-hook runner with a native Tama adaptive-runner shim after preserving a timestamped backup.

Replaces the legacy shared-hook runner with a native Tama adaptive-runner shim after preserving a timestamped backup.

#Invocation

DEVICE_HOOK_EDIT_APPROVED=1 tama adaptive install

The command takes no positional input or public options. Owner consent must set DEVICE_HOOK_EDIT_APPROVED=1 outside the agent session.

#Output and state

Tama backs up ~/.shared-hooks/run-hook.mjs, writes a shell shim that invokes this CLI's hidden adaptive runner, and verifies that the shim returns a passing decision. Success prints the installed path and backup path and exits 0.

#Refusals and failures

  • Missing consent: refusing to install: owner consent is missing. followed by the exact export instruction, exit 1.
  • Missing runner: legacy runner not found at <path>.
  • Backup or write failures: cannot create backup dir <path>, cannot back up legacy runner, or cannot write shim.
  • Verification failure: shim verification did not pass (<reason>); original runner restored from <path>. Tama restores the backup before exiting 1.

Return to the adaptive command group or the complete CLI tree.