feat: add /context command to display context information

Author: anilzeybek

CHANGELOG.md

@@ -11,6 +11,8 @@ Only write entries that are worth mentioning to users.
 
 ## Unreleased
 
+- Shell: Add `/context` command to display context information (messages, tokens, checkpoints)
+
 ## 1.5 (2026-01-30)
 
 - Web: Add Git diff status bar showing uncommitted changes in session working directory

docs/en/reference/slash-commands.md

@@ -65,6 +65,27 @@ This command is only available when using the default configuration file. If a c
 
 Reload the configuration file without exiting Kimi Code CLI.
 
+### `/context`
+
+Display context information for the current session.
+
+Output includes:
+- Total number of messages
+- Number of checkpoints
+- Token usage (showing current usage, maximum limit, and percentage)
+- Message counts by role (user, assistant, tool, etc.)
+
+```
+Context Info:
+  Total messages: 42
+  Checkpoints: 3
+  Token usage: 15,234 / 131,072 (11.6%)
+  Messages by role:
+    assistant: 18
+    tool: 12
+    user: 12
+```
+
 ### `/debug`
 
 Display debug information for the current context, including:

docs/en/release-notes/changelog.md

@@ -4,6 +4,8 @@ This page documents the changes in each Kimi Code CLI release.
 
 ## Unreleased
 
+- Shell: Add `/context` command to display context information (messages, tokens, checkpoints)
+
 ## 1.5 (2026-01-30)
 
 - Web: Add Git diff status bar showing uncommitted changes in session working directory

docs/zh/reference/slash-commands.md

@@ -65,6 +65,27 @@
 
 重新加载配置文件，无需退出 Kimi Code CLI。
 
+### `/context`
+
+显示当前会话的上下文信息。
+
+输出内容包括：
+- 消息总数
+- 检查点数量
+- Token 使用量（显示当前使用量、最大限制和百分比）
+- 按角色分类的消息统计（user、assistant、tool 等）
+
+```
+Context Info:
+  Total messages: 42
+  Checkpoints: 3
+  Token usage: 15,234 / 131,072 (11.6%)
+  Messages by role:
+    assistant: 18
+    tool: 12
+    user: 12
+```
+
 ### `/debug`
 
 显示当前上下文的调试信息，包括：

docs/zh/release-notes/changelog.md

@@ -4,6 +4,8 @@
 
 ## 未发布
 
+- Shell：添加 `/context` 命令用于显示上下文信息（消息数、token 数、检查点数）
+
 ## 1.5 (2026-01-30)
 
 - Web：添加 Git diff 状态栏，显示会话工作目录中的未提交更改

src/kimi_cli/soul/slash.py

@@ -78,3 +78,41 @@ async def yolo(soul: KimiSoul, args: str):
     else:
         soul.runtime.approval.set_yolo(True)
         wire_send(TextPart(text="You only live once! All actions will be auto-approved."))
+
+
+@registry.command
+async def context(soul: KimiSoul, args: str):
+    """Display context information (messages, tokens, checkpoints)"""
+    ctx = soul.context
+    history = ctx.history
+
+    if not history:
+        wire_send(TextPart(text="Context is empty - no messages yet."))
+        return
+
+    token_count = ctx.token_count
+    lines = [
+        "Context Info:",
+        f"  Total messages: {len(history)}\n",
+        f"  Checkpoints: {ctx.n_checkpoints}\n",
+    ]
+
+    # Add token usage with percentage if LLM is available
+    if soul.runtime.llm is not None:
+        max_context = soul.runtime.llm.max_context_size
+        usage_percent = (token_count / max_context * 100) if max_context > 0 else 0
+        lines.append(f"  Token usage: {token_count:,} / {max_context:,} ({usage_percent:.1f}%)\n")
+    else:
+        lines.append(f"  Token count: {token_count:,}\n")
+
+    # Count messages by role
+    role_counts: dict[str, int] = {}
+    for msg in history:
+        role_counts[msg.role] = role_counts.get(msg.role, 0) + 1
+
+    if role_counts:
+        lines.append("  Messages by role:")
+        for role, count in sorted(role_counts.items()):
+            lines.append(f"    {role}: {count}")
+
+    wire_send(TextPart(text="\n".join(lines)))