feat(statusline): add modelLabelAliases config for long model identifiers (#1219)

* feat(statusline): add modelLabelAliases config for long model identifiers

Adds a model_label_aliases hash map to the statusline config that lets
users define short display labels for long model identifiers (like AWS
Bedrock Inference Profile ARNs). When a model's display_name matches a
key in the aliases, the corresponding value is used instead in the
statusline output.

    Example config:
    {
      "commands": {
        "statusline": {
          "modelLabelAliases": {
            "arn:aws:bedrock:us-east-1:123:inference-profile/abc": "claude-opus"
          }
        }
      }
    }

Closes #896

* chore: regenerate config-schema.json with modelLabelAliases

* test(statusline): cover modelLabelAliases resolution and parsing

Extract the alias lookup in render_statusline into a small
resolve_model_label helper so the mapping is unit-testable without the
cost-aggregation machinery, and add tests:

- resolve_model_label maps a Bedrock ARN display name to its alias and
  falls back to the original display name when no alias matches.
- StatuslineSpecificOptions::from_map parses modelLabelAliases and
  ignores non-string values.

* docs(statusline): document modelLabelAliases config

Add the modelLabelAliases option to the statusline config example and a
dedicated "Model Label Aliases" section explaining how to map long model
identifiers (e.g. AWS Bedrock inference profile ARNs) to short labels.

---------

Co-authored-by: pullfrog[bot] <226033991+pullfrog[bot]@users.noreply.github.com>
Co-authored-by: ryoppippi <1560508+ryoppippi@users.noreply.github.com>

Author: pullfrog[bot]

apps/ccusage/config-schema.json

@@ -947,6 +947,14 @@
 											"markdownDescription": "Show statusline debug information.",
 											"type": "boolean"
 										},
+										"modelLabelAliases": {
+											"additionalProperties": {
+												"type": "string"
+											},
+											"description": "Map model identifiers to short display labels.",
+											"markdownDescription": "Map model identifiers to short display labels.",
+											"type": "object"
+										},
 										"noCache": {
 											"default": false,
 											"description": "Disable statusline cache.",
@@ -1187,6 +1195,14 @@
 									"markdownDescription": "Cost calculation mode.",
 									"type": "string"
 								},
+								"modelLabelAliases": {
+									"additionalProperties": {
+										"type": "string"
+									},
+									"description": "Map model identifiers to short display labels.",
+									"markdownDescription": "Map model identifiers to short display labels.",
+									"type": "object"
+								},
 								"noCache": {
 									"description": "Disable statusline cache.",
 									"markdownDescription": "Disable statusline cache.",
@@ -2646,6 +2662,14 @@
 									"markdownDescription": "Show statusline debug information.",
 									"type": "boolean"
 								},
+								"modelLabelAliases": {
+									"additionalProperties": {
+										"type": "string"
+									},
+									"description": "Map model identifiers to short display labels.",
+									"markdownDescription": "Map model identifiers to short display labels.",
+									"type": "object"
+								},
 								"noCache": {
 									"default": false,
 									"description": "Disable statusline cache.",

docs/guide/config-files.md

@@ -364,7 +364,10 @@ For a namespaced command, options are applied in this order:
 		"statusline": {
 			"offline": true,
 			"cache": true,
-			"refreshInterval": 2
+			"refreshInterval": 2,
+			"modelLabelAliases": {
+				"arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345": "claude-opus-4-6"
+			}
 		}
 	}
 }

docs/guide/statusline.md

@@ -289,6 +289,45 @@ bun x ccusage statusline --visual-burn-rate emoji
 - ⚠️ Moderate (Yellow)
 - 🚨 High (Red)
 
+### Model Label Aliases
+
+Some setups report very long model identifiers. For example, AWS Bedrock
+inference profiles surface full ARNs such as
+`arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345`,
+which gets truncated in the statusline and hides which model is in use.
+
+Use `modelLabelAliases` in your configuration file to map a model identifier to
+a short display label. When the active model matches a key, the statusline shows
+the alias instead:
+
+```json
+{
+	"commands": {
+		"statusline": {
+			"modelLabelAliases": {
+				"arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345": "claude-opus-4-6"
+			}
+		}
+	}
+}
+```
+
+With the alias above, the statusline changes from:
+
+```text
+🤖 arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345 | 💰 ...
+```
+
+to:
+
+```text
+🤖 claude-opus-4-6 | 💰 ...
+```
+
+Keys are matched exactly against the model's display name. Models without a
+matching alias are shown unchanged. See the [Configuration Guide](/guide/configuration)
+for more details.
+
 ## Troubleshooting
 
 ### No Output Displayed

rust/crates/ccusage-cli/src/types.rs

@@ -1,4 +1,4 @@
-use std::path::PathBuf;
+use std::{collections::HashMap, path::PathBuf};
 
 pub struct Cli {
     pub command: Option<Command>,
@@ -108,6 +108,7 @@ pub struct StatuslineArgs {
     pub timezone: Option<String>,
     pub config: Option<PathBuf>,
     pub debug: bool,
+    pub model_label_aliases: HashMap<String, String>,
 }
 
 #[derive(Clone)]
@@ -163,6 +164,7 @@ impl Default for StatuslineArgs {
             timezone: None,
             config: None,
             debug: false,
+            model_label_aliases: HashMap::new(),
         }
     }
 }

rust/crates/ccusage/src/commands/mod.rs

@@ -384,6 +384,22 @@ pub(crate) fn run_statusline(args: StatuslineArgs) -> Result<()> {
     Ok(())
 }
 
+/// Resolve the model label shown in the statusline.
+///
+/// Looks up the model's `display_name` in the user-configured alias map and
+/// returns the matching short label when present. Long identifiers such as AWS
+/// Bedrock inference profile ARNs can therefore be displayed as a concise name.
+/// Falls back to the original `display_name` when no alias matches.
+fn resolve_model_label<'a>(
+    aliases: &'a std::collections::HashMap<String, String>,
+    display_name: &'a str,
+) -> &'a str {
+    aliases
+        .get(display_name)
+        .map(String::as_str)
+        .unwrap_or(display_name)
+}
+
 fn render_statusline(
     hook: &StatuslineHook,
     args: &StatuslineArgs,
@@ -498,9 +514,11 @@ fn render_statusline(
             .unwrap_or_else(|| "N/A".to_string())
     };
 
+    let model_label = resolve_model_label(&args.model_label_aliases, &hook.model.display_name);
+
     Ok(format!(
         "🤖 {} | 💰 {} session / {} today / {}{} | 🧠 {}",
-        hook.model.display_name,
+        model_label,
         session_display,
         format_currency(today_cost),
         block_info,
@@ -909,4 +927,29 @@ mod tests {
             Some("stale status")
         );
     }
+
+    #[test]
+    fn resolves_model_label_from_alias_map() {
+        let mut aliases = std::collections::HashMap::new();
+        aliases.insert(
+            "arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345"
+                .to_string(),
+            "claude-opus-4-6".to_string(),
+        );
+
+        assert_eq!(
+            resolve_model_label(
+                &aliases,
+                "arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345"
+            ),
+            "claude-opus-4-6"
+        );
+    }
+
+    #[test]
+    fn falls_back_to_display_name_when_no_alias_matches() {
+        let aliases = std::collections::HashMap::new();
+
+        assert_eq!(resolve_model_label(&aliases, "Opus 4.1"), "Opus 4.1");
+    }
 }

rust/crates/ccusage/src/config.rs

@@ -347,6 +347,9 @@ pub(crate) fn apply_config_to_statusline_args(args: &mut StatuslineArgs, config:
         if let Some(debug) = options.debug {
             args.debug = debug;
         }
+        if let Some(aliases) = options.model_label_aliases {
+            args.model_label_aliases = aliases;
+        }
     }
 }
 

rust/crates/ccusage/src/config_schema.rs

@@ -1,5 +1,7 @@
 #![allow(dead_code)]
 
+use std::collections::HashMap;
+
 use serde::de::DeserializeOwned;
 use serde::Deserialize;
 use serde_json::{json, Map, Value};
@@ -432,6 +434,8 @@ pub(crate) struct StatuslineSpecificOptions {
     pub(crate) timezone: Option<String>,
     /// Show statusline debug information.
     pub(crate) debug: Option<bool>,
+    /// Map model identifiers to short display labels.
+    pub(crate) model_label_aliases: Option<HashMap<String, String>>,
 }
 
 #[derive(Debug, Default, Deserialize, JsonSchema)]
@@ -581,6 +585,7 @@ impl StatuslineSpecificOptions {
             context_medium_threshold: u64_option(map, "contextMediumThreshold"),
             timezone: string_option(map, "timezone"),
             debug: bool_option(map, "debug"),
+            model_label_aliases: hashmap_option(map, "modelLabelAliases"),
         }
     }
 }
@@ -720,6 +725,21 @@ where
     serde_json::from_value(map.get(key)?.clone()).ok()
 }
 
+fn hashmap_option(map: &Map<String, Value>, key: &str) -> Option<HashMap<String, String>> {
+    let obj = map.get(key)?.as_object()?;
+    let mut result = HashMap::new();
+    for (k, v) in obj {
+        if let Some(s) = v.as_str() {
+            result.insert(k.clone(), s.to_string());
+        }
+    }
+    if result.is_empty() {
+        None
+    } else {
+        Some(result)
+    }
+}
+
 fn enrich_schema(value: &mut Value) {
     match value {
         Value::Object(map) => {
@@ -917,6 +937,7 @@ mod tests {
     use serde_json::{json, Value};
 
     use super::generate_config_schema_json;
+    use super::StatuslineSpecificOptions;
 
     #[test]
     fn schema_option_sets_expose_expected_keys() {
@@ -969,6 +990,7 @@ mod tests {
                 "contextMediumThreshold",
                 "costSource",
                 "debug",
+                "modelLabelAliases",
                 "noCache",
                 "noOffline",
                 "offline",
@@ -1248,6 +1270,39 @@ mod tests {
         );
     }
 
+    #[test]
+    fn statusline_options_parse_model_label_aliases() {
+        let map = serde_json::json!({
+            "modelLabelAliases": {
+                "arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345": "claude-opus-4-6"
+            }
+        });
+        let options = StatuslineSpecificOptions::from_map(map.as_object().unwrap());
+
+        let aliases = options.model_label_aliases.unwrap();
+        assert_eq!(
+            aliases.get(
+                "arn:aws:bedrock:ap-northeast-1:012345678910:application-inference-profile/abcde12345"
+            ),
+            Some(&"claude-opus-4-6".to_string())
+        );
+    }
+
+    #[test]
+    fn statusline_options_ignore_non_string_alias_values() {
+        let map = serde_json::json!({
+            "modelLabelAliases": {
+                "valid": "short",
+                "invalid": 123
+            }
+        });
+        let options = StatuslineSpecificOptions::from_map(map.as_object().unwrap());
+
+        let aliases = options.model_label_aliases.unwrap();
+        assert_eq!(aliases.get("valid"), Some(&"short".to_string()));
+        assert!(!aliases.contains_key("invalid"));
+    }
+
     #[test]
     fn snapshots_schema_agent_specific_option_edges() {
         if running_in_schema_generator_test_binary() {

rust/crates/ccusage/src/snapshots/ccusage__config_schema__tests__snapshots_schema_agent_specific_option_edges.snap

@@ -47,6 +47,14 @@ expression: "json!({\n    \"rootRef\": schema[\"$ref\"], \"rootProperties\":\n
         "markdownDescription": "Show statusline debug information.",
         "type": "boolean"
       },
+      "modelLabelAliases": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "description": "Map model identifiers to short display labels.",
+        "markdownDescription": "Map model identifiers to short display labels.",
+        "type": "object"
+      },
       "noCache": {
         "default": false,
         "description": "Disable statusline cache.",