ftime

English | 日本語 | 中文

A tiny, read-only CLI that lists recently modified files and directories in time buckets (depth 1).

Features

• 4 time buckets by mtime: Active (<1h) / Today / This Week (<7d) / History
• TTY output: color + buckets, History collapsed by default (--all), max 20 items per bucket
• Pipe/redirect output: tab-separated plain text (no headers, no colors, no icons)
• JSON Lines: --json (default build)
• Filters: --ext, ignore rules (~/.ftimeignore, <PATH>/.ftimeignore, FTIME_IGNORE, --no-ignore)

Quickstart

ftime

Install

GitHub Releases (recommended)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/tsutomu-n/ftime/main/scripts/install.sh | bash

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -Command "iwr https://raw.githubusercontent.com/tsutomu-n/ftime/main/scripts/install.ps1 -UseBasicParsing | iex"

crates.io (when published)

cargo install ftime

From source (build + install)

Requires Rust/Cargo 1.92+ (edition 2024).

cargo install --path .
ftime --version

cargo build --release only builds target/release/ftime and does not add it to your PATH.

Usage

ftime [OPTIONS] [PATH]

Common options:

• -a, --all Show History bucket (TTY mode)
• -H, --hidden Include dotfiles
• --ext rs,toml Filter by extensions (files only)
• --json JSON Lines output (if built with default features)
• --no-ignore Disable ignore rules
• --no-labels Disable best-effort labels (e.g. Fresh)

Docs

• Japanese README: docs/README-ja.md
• Chinese README: docs/README-zh.md
• User guide (Japanese): docs/USER-GUIDE-ja.md
• CLI contract: docs/CLI.md

License

MIT (see LICENSE)