diff --git a/crates/bascule-shell/src/config.rs b/crates/bascule-shell/src/config.rs
index 5a11f51..9cdc6cb 100644
--- a/crates/bascule-shell/src/config.rs
+++ b/crates/bascule-shell/src/config.rs
@@ -6,13 +6,21 @@ pub struct ShellConfig {
     pub inner_shell: String,
     #[serde(default = "default_true")]
     pub show_banner: bool,
+    /// User-configured Bascule server endpoints. The bascule-shell
+    /// binary deserializes them from `~/.config/bascule/shell.toml`
+    /// but never reads them at runtime today; the shell-side server
+    /// chooser uses `dev.gsh` / `stg.gsh` / `prod.gsh` SSH host
+    /// aliases instead. Retained so the TOML schema doesn't break
+    /// for users who already have entries in their config.
     #[serde(default)]
+    #[allow(dead_code)]
     pub servers: Vec<BasculeServer>,
     #[serde(default = "default_pcr_indices")]
     pub pcr_indices: Vec<u32>,
 }
 
 #[derive(Debug, Deserialize, Clone)]
+#[allow(dead_code)] // TOML wire-format fields; see ShellConfig.servers comment.
 pub struct BasculeServer {
     pub alias: String,
     pub hostname: String,