@tim-fs/cli

@tim-fs/cli

The public command-line package for TIM/FS, a filesystem event bus for explicit, inspectable automation.

Run with npx

npx @tim-fs/cli init
npx @tim-fs/cli start [directory]

init stores optional provider credentials in ~/.tim/.env and installs bundled prompts in ~/.tim/prompts. start defaults to the current directory and stays in the foreground until you press Ctrl-C.

Install globally

npm install --global @tim-fs/cli
tim init
tim start ~/workspace

Or run the Bash installer, which checks for Node.js 20+ and wraps the same global npm install:

curl -fsSL https://raw.githubusercontent.com/dht/tim-fs/main/cli/install.sh | bash

See brew.md for a suggested Homebrew tap and formula.

See the repository README for configuration, included bots, and source development.