Skip to content
fsuite

📂 fls

Structured directory listing with recon mode

Section titled “Structured directory listing with recon mode”

fls is part of the fsuite toolkit — a set of fourteen CLI tools built for AI coding agents.

fls Structured directory listing · ls replacement with recon mode
RoleRECON
Chain positionspecialist
Pipenot chainable
Outputpretty · json

fls is the surgical version of ftree — one directory, one level deep (configurable), with structured metadata: type, size, language hints. When ftree would be too noisy and cat-ing a path tells you nothing, fls shows you exactly what’s in this folder and nothing else.

--recon mode adds per-entry sizes and counts in a clean column layout. JSON mode lets agents make programmatic decisions on what to read next.

Canonical chains

Section titled “Canonical chains”
Terminal window
# Structured listing — type, size, language hints
fls /project/src


# Recon mode — sizes + counts, scannable column layout
fls /project/src/telegram --recon


# JSON for agents
fls /project -o json


# Limit depth (default 1, often plenty)
fls /project --depth 1

Terminal sample

Section titled “Terminal sample”
fls(/project/src/telegram) · recon mode
fls("/home/user/Projects/nightfox/src/telegram" | mode: "recon")
  └─ Recon(/home/user/Projects/nightfox/src/telegram, depth=1)
     7 entries (7 visible, 0 default-excluded)
·
     message-sender.ts          —    17.9K
     telegraph.ts               —    12K
     terminal-renderer.ts       —    10.3K
     markdown.ts                —    6.7K
     terminal-settings.ts       —    2.8K
     session-lane.ts            —    1.2K
     deduplication.ts           —    1005
·

Help output

Section titled “Help output”

The content below is the live --help output of fls, captured at build time from the tool binary itself. It cannot drift from the source — regenerating the docs regenerates this section.

fls — list directory contents (thin ftree router)


USAGE
  fls [options] [path]


MODES
  (default)        List direct children          → ftree -L 1
  -t, --tree       Little tree, shallow structure → ftree -L 2
  -r, --recon      Recon with sizes and counts   → ftree --recon -L 1


OPTIONS
  -o, --output <fmt>   pretty (default) or json
  -h, --help           Show this help
  --version            Show version


HEADLESS / AI AGENT USAGE
  fls -o json /path      Structured JSON — inherits ftree's JSON contract.
  fls -t -o json /path   Shallow tree as JSON.
  fls -r -o json /path   Recon metadata as JSON.


  Output IS ftree output. Parse the same fields: tool, mode, depth,
  total_dirs, total_files, entries (recon), tree output (tree mode).


EXAMPLES
  fls                    List cwd
  fls src/               List src/
  fls -t src/            Shallow tree of src/
  fls -r .               Recon: sizes and item counts
  fls -o json src/       JSON for agents

See also

Section titled “See also”