diff --git a/.cargo/config.toml b/.cargo/config.toml
index 524435b2..7d4c3809 100644
--- a/.cargo/config.toml
+++ b/.cargo/config.toml
@@ -1,5 +1,5 @@
 [alias]
-crowtty = "run --bin crowtty --release --"
+crowtty = "run --package crowtty --bin crowtty --release --"
 melpomene = "run --bin melpomene --release --"
 melpo = "melpomene"
 forth3 = "run --bin f3repl --release --"
@@ -23,7 +23,7 @@ runner = "cargo run --package mnemos-x86_64-bootimager -- --kernel-bin"
 # `rust-osdev/bootloader`, where a target crate depends on the kernel binary
 # artifact from the kernel core crate and links it with the bootloader binary in
 # a `build.rs` script.
-# 
+#
 # Artifact dependencies are also used by `manganese` to depend on binary crates
 # as normal Cargo.toml dependencies.
 #
diff --git a/Cargo.toml b/Cargo.toml
index 252f877b..23c55217 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -49,6 +49,10 @@ default-members = [
     # tools
     # note that this skips `manganese` by default, so that we don't build its
     # dependency features when running `cargo check --all-features` and similar.
+    #
+    # also, crowtty is excluded by default, as it depends on `libudev` on Linux,
+    # and we would like to be able to build documentation without having to
+    # install libudev on CI.
     "tools/libcrowtty",
     "tools/dumbloader",
     "tools/f3repl",
diff --git a/justfile b/justfile
index 8f28d7d7..46adc623 100644
--- a/justfile
+++ b/justfile
@@ -181,7 +181,7 @@ _x86-bootimager cmd *args='':
 
 # run crowtty (a host serial multiplexer, log viewer, and pseudo-keyboard)
 crowtty *FLAGS:
-    {{ _cargo }} run --profile {{ profile }} --bin crowtty -- {{ FLAGS }}
+    {{ _cargo }} run --package crowtty --profile {{ profile }} --bin crowtty -- {{ FLAGS }}
 
 # run the Melpomene simulator
 melpomene *FLAGS: