diff --git a/TOKEN_DISPLAY_SPEC.md b/TOKEN_DISPLAY_SPEC.md
new file mode 100644
index 0000000..edad217
--- /dev/null
+++ b/TOKEN_DISPLAY_SPEC.md
@@ -0,0 +1,269 @@
+# Token Display Specification
+
+**Version:** 1.1.0
+**Date:** 2026-11-10
+**Status:** Draft
+**Author:** LLM Assistant
+
+## Overview
+
+This specification adds token usage display to both GUI and CLI interfaces of agent-cost-estimator.
+
+## Summary of Changes
+
+1. **GUI:** Add 3 columns (Input/Output/Cached tokens) with automatic suffixes (k, M, B, T)
+2. **GUI:** Add monthly usage summary row as first row under each harness
+3. **CLI:** Add token usage line with format `-- I:X O:Y C:Z`
+
+## 1. Formatting Function
+
+Create a utility function to format token counts with automatic suffixes:
+
+```python
+# File: agent_cost_estimator/utils/formatting.py
+
+def format_token_count(count: int) -> str:
+ """Format token count with automatic suffix for large numbers.
+
+ Args:
+ count: Non-negative integer token count
+
+ Returns:
+ String with suffix: 0-999 (no suffix), 1k+, 1M+, 1B+, 1T+
+ Always uses 2 decimal places for suffixed values.
+
+ Examples:
+ 0 -> "0"
+ 500 -> "500"
+ 1000 -> "1.00k"
+ 1500 -> "1.50k"
+ 1000000 -> "1.00M"
+ 1000000000 -> "1.00B"
+ 1000000000000 -> "1.00T"
+ """
+ if count < 1000:
+ return str(count)
+ elif count < 1_000_000:
+ return f"{count / 1000:.2f}k"
+ elif count < 1_000_000_000:
+ return f"{count / 1_000_000:.2f}M"
+ elif count < 1_000_000_000_000:
+ return f"{count / 1_000_000_000:.2f}B"
+ else:
+ return f"{count / 1_000_000_000_000:.2f}T"
+```
+
+## 2. CLI Changes
+
+### Default Output
+
+**Current:**
+```
+-- provider:model | session:$X.XX | turn:$Y.YY
+```
+
+**New:**
+```
+-- provider:model | session:$X.XX | turn:$Y.YY
+-- I: O: