English | 日本語 | 中文

ftime is a read-only CLI for answering one question quickly:

What changed in this folder recently?

The name stands for files by time. It scans only the first level of a directory, sorts entries by mtime, and groups them into time buckets so you can recover context without recursive noise.

• Read-only by design: no delete, rename, or write operations
• Depth-1 only: see the current folder, not the whole tree
• Buckets: Active / Today / This Week / History
• Human-first bucket view by default
• hidden files stay visible by default while hidden directories stay hidden
• Use --plain or --json when you want machine-oriented output

Use it when you want to:

• clean up ~/Downloads
• check build output in ./target
• inspect a log or sync folder
• answer "did anything change here?" in seconds

ftime
ftime ~/Downloads
ftime -a
ftime --all-history
ftime --since 24h
ftime --hide-dots
ftime --plain
ftime --json | jq -r '.path'

--json emits one JSON object per line, so it works well with jq and other scripts. --since filters entries by a lower bound before bucketing.

Active (1)
  [FIL]  Cargo.toml  2.1 KiB          12s

Today (1)
  [FIL]  README.md   8.4 KiB          2h

This Week (1)
  [DIR]  docs/        <dir>          3d

History (1)
  [DIR]  target/      <dir>  2026-03-16

Directories show <dir> and symlinks show <lnk> in the size column. Pass --hints when you want directory child activity hints such as [child: today]. Use --plain or --json when you need full machine-readable values without human-view truncation or color.

macOS / Linux:

curl -fsSL https://github.com/tsutomu-n/ftime/releases/latest/download/ftime-install.sh | bash

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -Command "iwr https://github.com/tsutomu-n/ftime/releases/latest/download/ftime-install.ps1 -UseBasicParsing | iex"

cargo install ftime --locked
ftime --version

--self-update is intended for GitHub Releases installs. If you installed via cargo install, update with cargo install --locked --force instead.

For custom install paths, from-source installs, --check-update, --self-update, and uninstall steps, see docs/INSTALL.md.

• Command guide
• Install and update guide
• CLI contract
• 日本語
• 中文
• Japanese docs router
• User guide (Japanese)

MIT (see LICENSE)