diff --git a/cli/src/cli_util.rs b/cli/src/cli_util.rs
index a72e89e9ff..d33142d5da 100644
--- a/cli/src/cli_util.rs
+++ b/cli/src/cli_util.rs
@@ -2391,8 +2391,8 @@ pub struct EarlyArgs {
     pub color: Option<ColorChoice>,
     /// Silence non-primary command output
     ///
-    /// For example, `jj files` will still list files, but it won't tell you if
-    /// the working copy was snapshotted or if descendants were rebased.
+    /// For example, `jj file list ` will still list files, but it won't tell
+    /// you if the working copy was snapshotted or if descendants were rebased.
     ///
     /// Warnings and errors will still be printed.
     #[arg(long, global = true, action = ArgAction::SetTrue)]
diff --git a/cli/src/commands/file/chmod.rs b/cli/src/commands/file/chmod.rs
index 77c97d9bc8..8310a5c221 100644
--- a/cli/src/commands/file/chmod.rs
+++ b/cli/src/commands/file/chmod.rs
@@ -34,8 +34,8 @@ enum ChmodMode {
 
 /// Sets or removes the executable bit for paths in the repo
 ///
-/// Unlike the POSIX `chmod`, `jj chmod` also works on Windows, on conflicted
-/// files, and on arbitrary revisions.
+/// Unlike the POSIX `chmod`, `jj file chmod` also works on Windows, on
+/// conflicted files, and on arbitrary revisions.
 #[derive(clap::Args, Clone, Debug)]
 pub(crate) struct ChmodArgs {
     mode: ChmodMode,
diff --git a/cli/tests/cli-reference@.md.snap b/cli/tests/cli-reference@.md.snap
index 431229e56a..dd045bbd26 100644
--- a/cli/tests/cli-reference@.md.snap
+++ b/cli/tests/cli-reference@.md.snap
@@ -177,7 +177,7 @@ To get started, see the tutorial at https://github.com/martinvonz/jj/blob/main/d
 * `--color <WHEN>` — When to colorize output (always, never, debug, auto)
 * `--quiet` — Silence non-primary command output
 
-   For example, `jj files` will still list files, but it won't tell you if the working copy was snapshotted or if descendants were rebased.
+   For example, `jj file list ` will still list files, but it won't tell you if the working copy was snapshotted or if descendants were rebased.
 
    Warnings and errors will still be printed.
 * `--no-pager` — Disable the pager
@@ -698,7 +698,7 @@ File operations
 
 Sets or removes the executable bit for paths in the repo
 
-Unlike the POSIX `chmod`, `jj chmod` also works on Windows, on conflicted files, and on arbitrary revisions.
+Unlike the POSIX `chmod`, `jj file chmod` also works on Windows, on conflicted files, and on arbitrary revisions.
 
 **Usage:** `jj file chmod [OPTIONS] <MODE> <PATHS>...`
 
diff --git a/docs/filesets.md b/docs/filesets.md
index 9735a87903..567aec0b1c 100644
--- a/docs/filesets.md
+++ b/docs/filesets.md
@@ -74,7 +74,7 @@ jj diff '~Cargo.lock'
 List files in `src` excluding Rust sources.
 
 ```
-jj files 'src ~ glob:"**/*.rs"'
+jj file list 'src ~ glob:"**/*.rs"'
 ```
 
 Split a revision in two, putting `foo` into the second commit.
diff --git a/docs/git-comparison.md b/docs/git-comparison.md
index dbda867610..03c17af100 100644
--- a/docs/git-comparison.md
+++ b/docs/git-comparison.md
@@ -196,7 +196,7 @@ parent.
     </tr>
     <tr>
       <td>Search among files versioned in the repository</td>
-      <td><code>grep foo $(jj files)</code>, or <code>rg --no-require-git foo</code></td>
+      <td><code>grep foo $(jj file list)</code>, or <code>rg --no-require-git foo</code></td>
       <td><code>git grep foo</code></td>
     </tr>
     <tr>