Skip to content

Add completion spec: tree#257

Merged
lucieleblanc merged 1 commit into
mainfrom
app-3957/command-spec-tree
Apr 10, 2026
Merged

Add completion spec: tree#257
lucieleblanc merged 1 commit into
mainfrom
app-3957/command-spec-tree

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

Summary

Add command completion spec for tree, a recursive directory listing utility.

Addresses APP-3957.

What's included

  • JSON spec (command-signatures/json/tree.json) covering all flags/options from tree --help and Fish shell completions
  • Listing options: -a, -d, -l, -f, -x, -L, -R, -P, -I, --gitignore, --gitfile, --ignore-case, --matchdirs, --metafirst, --prune, --info, --infofile, --noreport, --charset, --filelimit, -o
  • File options: -q, -N, -Q, -p, -u, -g, -s, -h, --si, --du, -D, --timefmt, -F, --inodes, --device
  • Sorting options: -v, -t, -c, -U, -r, --dirsfirst, --filesfirst, --sort (with static suggestions: name, version, size, mtime, ctime)
  • Graphics options: -i, -A, -S, -n, -C
  • XML/HTML/JSON options: -X, -J, -H, -T, --nolinks, --hintro, --houtro
  • Input options: --fromfile, --fromtabfile, --fflinks
  • Misc: --version, --help
  • Positional argument accepts variadic optional folders (using the folders template)

No generators

This command uses only static flags, options, and suggestions — no dynamic generators are needed.

Testing

All completions verified in a local Warp build with cargo run --features fast_dev:

  1. Short flag completions (tree - + Tab) — shows -A, -a, -C, -c, -D, -d, etc.
  2. Long flag completions (tree -- + Tab) — shows --charset, --device, --dirsfirst, --du, --fflinks, --filelimit, etc.
  3. Sort suggestions (tree --sort + Tab) — shows ctime, mtime, name, size, version

All presubmit checks pass (prettier formatting, cargo fmt, cargo clippy, cargo test — 54+10 tests).


Conversation: https://staging.warp.dev/conversation/4f071408-ca9b-4182-9bcf-0c13e4c2d8f4
Run: https://oz.staging.warp.dev/runs/019d744d-205e-7e8a-b2ab-5c0827c29ba5
This PR was generated with Oz.

Add command completions for tree, a recursive directory listing utility.
Includes all flags, options, and static suggestions for --sort.

Co-Authored-By: Oz <oz-agent@warp.dev>
@linear
Copy link
Copy Markdown

linear Bot commented Apr 9, 2026

APP-3957 [Auto] Add tree completions

Add command completions for tree, a recursive directory listing utility.

Fish shell reference implementation: https://github.com/fish-shell/fish-shell/blob/master/share/completions/tree.fish

Copy link
Copy Markdown
Contributor Author

Completion Screenshots

Screenshots taken during local testing with cargo run --features fast_dev:

Note: Screenshots were captured during testing but could not be uploaded via the sandbox environment. The three tests performed were:

  1. tree - + Tab → dropdown showing short flags (-A, -a, -C, -c, -D, -d, etc.)
  2. tree -- + Tab → dropdown showing long flags (--charset, --device, --dirsfirst, --du, --fflinks, --filelimit, etc.)
  3. tree --sort + Tab → dropdown showing sort suggestions (ctime, mtime, name, size, version)

All completions were verified working correctly in the Warp completion dropdown menu.

@lucieleblanc lucieleblanc marked this pull request as ready for review April 10, 2026 02:56
@lucieleblanc lucieleblanc merged commit 31421c3 into main Apr 10, 2026
3 checks passed
@lucieleblanc lucieleblanc deleted the app-3957/command-spec-tree branch April 10, 2026 15:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants